Skip to main content

Validador de Linha Digitável de Boleto

A linha digitável é a informação mais importante de um boleto bancário! Ela contém todas as informações necessárias para identificar o documento, efetuar o pagamento e garantir que o valor seja direcionado para a conta correta. O validador de linha digitável garante que as informações contidas nessa linha sejam válida e confiável.

Personalizando a Validação​

Para adaptar o validador às suas necessidades, você pode usar os seguintes parâmetros:

  • bancos (opcional): Os três primeiros números da linha digitável representam o código do banco emissor, de acordo com a tabela da Febraban. Com este parâmetro, você pode especificar uma lista de códigos de bancos aceitos. Se o código do banco na linha digitável não estiver na lista, a validação falhará.

    • Exemplo: ["001", "237", "341"] (Banco do Brasil, Bradesco e Itaú)

  • moeda (opcional): O quarto número da linha digitável indica o tipo de moeda utilizada no boleto:

    • 9: Real (BRL)
    • 0: Outras moedas (Euro, Dólar, etc.)

    Com este parâmetro, você pode especificar qual moeda é esperada. Você pode usar as seguintes opções:

    • "real": Valida se o quarto dígito é igual a 9.
    • "euro", "dólar", ou qualquer outro valor: Valida se o quarto dígito é igual a 0.

    Se você não fornecer este parâmetro, o validador assumirá que a moeda padrão é o Real ("real").

O Que o Validador Checa​

Nosso validador realiza as seguintes verificações para garantir a validade da linha digitável:

  • Quantidade de Caracteres: Garante que a linha digitável contenha exatamente 47 caracteres.

  • Código do Banco: Verifica se os três primeiros dígitos da linha digitável correspondem a um dos códigos de bancos aceitos, conforme especificado no parâmetro bancos. Se o parâmetro bancos não for fornecido, o validador usará a seguinte lista de bancos como padrão:

    • "001": Banco do Brasil
    • "033": Santander
    • "104": Caixa Econômica Federal
    • "041": Banrisul
    • "237": Bradesco
    • "341": Itaú
    • "756": Uniftec (inferido)

  • Moeda: Verifica se o quarto dígito da linha digitável corresponde à moeda esperada, conforme especificado no parâmetro moeda. Se o parâmetro moeda for fornecido como "real", o validador verificará se o quarto dígito é igual a 9. Para qualquer outro valor (por exemplo, "euro", "dólar"), o validador verificará se o quarto dígito é igual a 0. Se o parâmetro moeda não for fornecido, o validador assumirá que a moeda padrão é o Real e verificará se o quarto dígito é igual a 9.

Ao usar o validador de Linha Digitável de Boleto, você garante que as informações contidas na linha digitável sejam válidas e consistentes, minimizando o risco de erros de pagamento e garantindo a segurança das suas transações.