Erros

Rate limit

Todas as chamadas das APIs de autenticação possuem um rate limit de 10 requisições por segundo. As chamadas para as APIs de validação possuem um rate limit de 20 requisições por segundo. Caso esse limite seja atingido você receberá um retorno de um erro com HTTP status code 429.

Além disso, há um rate limit específico para validações de chaves Pix ou dados bancários, limitado a 12 tentativas por hora para a mesma chave ou conjunto de dados bancários completos. Se esse limite for ultrapassado, também será retornado um erro com o HTTP status code 429 e código de erro CCE_7.

Response de erro

Os erros listados abaixo são agrupados por contexto e pode ser apresentado em situações diversas. O erro contêm:

  • data: Informações adicionais.
  • error: Descrição do erro.
  • errorCode: Estes códigos e descrições do erro são listados abaixo conforme o contexto do produto (validações, Pix, Destination Bank Account...).
  • field: Informações adicionais.
  • message: Mensagem de erro.
  • statusCode: Código do erro.

Exemplo de response:

{
  "data": {
    "maxLength": 8,
    "minLength": 7
  },
  "error": "Bad Request",
  "errorCode": "DBA_6",
  "field": "account",
  "message": "Account is required and must have between 7 and 8 numbers (Agency: 0001 / Account: 111111 / Value: 10)",
  "statusCode": 400
}

Validações

CódigoMensagem
CCE_1Micro deposit is not allowed for your account *
CCE_2Specify the micro deposit value is not allowed for your account *
CCE_3Description is only allowed in Pix validations *
CCE_4Pix description can not be greater than 140 characters
CCE_5The Pix description cannot contain unsafe html tags
CCE_6Basic validation is not allowed for your account *
CCE_7Micro deposit validation limit exceeded for this bank account or Pix key

📘

Para habilitar este recurso é só entrar em contato com o nosso suporte pelo email [email protected]

Destination Bank Account (DBA)

CódigoMensagem
DBA_1Dígito da agência é obrigatório e deve ser numérico ou x
DBA_2Dígito da conta é obrigatório e deve ser numérico ou x
DBA_3

Agência deve ser 1
Agência inválida

DBA_4Agência é obrigatória e deve conter no máximo {maxLength} números
DBA_5Dígito da agência deve ter apenas 1 dígito
DBA_6Conta é obrigatória e deve conter no máximo {maxLength} números
DBA_7Conta é obrigatória e deve conter entre {minLength} e {maxLength} números
DBA_8Dígito da Conta é obrigatório e deve ter apenas 1 dígito
DBA_9Conta do banco é obrigatória e deve conter exatamente {exactLength} números
DBA_10

Tipo de conta inválido
Tipo da conta inválido.
Tipo da conta do favorecido inválido.

DBA_11

Tipo de conta 'Entidade pública' é disponível somente para CNPJ

Tipo de conta 'Entidade pública' só permite pessoa jurídica.

DBA_12

Documento do favorecido não é um CPF nem CNPJ
CPF/CNPJ é obrigatório

Documento {document} não é um CPF ou CNPJ

DBA_13

O CPF ou CNPJ está bloqueado

Documento {document} está bloqueado

DBA_15O nome é obrigatório
DBA_19Dígito da Agência não é válido
DBA_20

Conta ou dígito verificador da conta inválido.

Dígito verificador da conta inválido.

DBA_21Conta inválida.
DBA_22Agência não existe
DBA_23Documento não existe
DBA_24Nome informado não coincide com o nome no Documento
DBA_26Conta inválida. O inicio da conta {accountBeginning} não é reconhecido como um tipo válido.
DBA_27CNPJ {document} inválido
DBA_28CPF {document} inválido
DBA_29Agência, tipo da conta, conta ou dígito verificador da conta inválido.
DBA_30Agência, conta ou dígito verificador da conta inválido.
DBA_33Bank Code is required and must have a maximum of 3 numbers
DBA_34This banking institution is not eligible to receive payments
DBA_35The name must have at least 3 characters
DBA_41Bank ISPB is required and must have exactly 8 numbers
DBA_42This banking institution is not eligible to receive payments
DBA_44Destination Bank Account was provided with bank code and ISPB, please provide only one bank info
DBA_45Bank code or ISPB are required
DBA_48Inconsistency in the registration status of the document

Chave Pix

CódigoMensagem
PIX_1Invalid PIX key type
PIX_2The email must be valid
PIX_4The phone number must be valid
PIX_15Pix key not found
PIX_28Format of EVP key is invalid
PIX_29Inconsistency in the registration status of the document
PIX_33The document format is invalid
PIX_34Document does not exist
PIX_35Informed document is divergent from Pix key owner
PIX_36Invalid phone key area code

HTTP status codes

CódigoDescrição
200OK
201Created
204No Content
400Requisição inválida
401Não autenticado
403Não autorizado
429Too Many Requests
5xxOcorreu algum erro interno no servidor.
Consulte a página de status para mais informações:
https://status.transfeera.com/