Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

e-Bank beneficiarionomevalidacao40 caracteresregistro boleto

Campo: Nome do Beneficiário deve conter entre 0 e 40 caracteres

Campo: 'Nome Do Beneficiario' - O campo deve conter entre 0 e 40 caracteres Este erro ocorre durante o registro do boleto quando o campo Nome do Beneficiário ultrapassa o limite permitido pelo banco. Campo: "N...

Atualizado em 11 de fev. de 2026, 20:06

Problema

Campo: 'Nome Do Beneficiario' - O campo deve conter entre 0 e 40 caracteres

Este erro ocorre durante o registro do boleto quando o campo Nome do Beneficiário ultrapassa o limite permitido pelo banco.

Campo: "Nome Do Beneficiario" - O campo deve conter entre 0 e 40 caracteres

O banco aceita no máximo 40 caracteres para o nome do beneficiário.

Esse campo é enviado dentro do objeto beneficiariono JSON da requisição:

"beneficiario": {
    "codigo": "123",
    "codigoContrato": "string",
    "codigoConvenio": "string",
    "conta": {
      "agencia": "string",
      "banco": "string",
      "codigoOperacaoConta": "string",
      "digitoVerificador": "string",
      "digitoVerificadorAgencia": "string",
      "numero": "string"
    },
    "inscricao": "03813865000165",
    "nome": "Fulano Ciclano"
}

Se o campo nome ultrapassar 40 caracteres, o banco rejeitará o registro.

Solução

Como resolver

Existem duas formas de corrigir esse problema:

  1. Ajustar o nome do beneficiário para até 40 caracteres:
    Reduza o texto enviado no campo nome para no máximo 40 caracteres.
  2. Não enviar o objeto beneficiario manualmente:
    Caso o beneficiário já esteja configurado no banco ou no sistema, evite enviar esse objeto no JSON.

Após ajustar o nome para até 40 caracteres, reenvie o registro do boleto.

Se houver dúvidas sobre qual nome deve ser utilizado, entre em contato com o suporte: