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

📘

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

Destination Bank Account (DBA)

Chave Pix

HTTP status codes