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ódigo | Mensagem |
|---|---|
| CCE_1 | Micro deposit is not allowed for your account * |
| CCE_2 | Specify the micro deposit value is not allowed for your account * |
| CCE_3 | Description is only allowed in Pix validations * |
| CCE_4 | Pix description can not be greater than 140 characters |
| CCE_5 | The Pix description cannot contain unsafe html tags |
| CCE_6 | Basic validation is not allowed for your account * |
| CCE_7 | Micro 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ódigo | Mensagem |
|---|---|
| DBA_1 | Dígito da agência é obrigatório e deve ser numérico ou x |
| DBA_2 | Dígito da conta é obrigatório e deve ser numérico ou x |
| DBA_3 | Agência deve ser 1 |
| DBA_4 | Agência é obrigatória e deve conter no máximo {maxLength} números |
| DBA_5 | Dígito da agência deve ter apenas 1 dígito |
| DBA_6 | Conta é obrigatória e deve conter no máximo {maxLength} números |
| DBA_7 | Conta é obrigatória e deve conter entre {minLength} e {maxLength} números |
| DBA_8 | Dígito da Conta é obrigatório e deve ter apenas 1 dígito |
| DBA_9 | Conta do banco é obrigatória e deve conter exatamente {exactLength} números |
| DBA_10 | Tipo de conta 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 Documento {document} não é um CPF ou CNPJ |
| DBA_13 | O CPF ou CNPJ está bloqueado Documento {document} está bloqueado |
| DBA_15 | O nome é obrigatório |
| DBA_19 | Dí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_21 | Conta inválida. |
| DBA_22 | Agência não existe |
| DBA_23 | Documento não existe |
| DBA_24 | Nome informado não coincide com o nome no Documento |
| DBA_26 | Conta inválida. O inicio da conta {accountBeginning} não é reconhecido como um tipo válido. |
| DBA_27 | CNPJ {document} inválido |
| DBA_28 | CPF {document} inválido |
| DBA_29 | Agência, tipo da conta, conta ou dígito verificador da conta inválido. |
| DBA_30 | Agência, conta ou dígito verificador da conta inválido. |
| DBA_33 | Bank Code is required and must have a maximum of 3 numbers |
| DBA_34 | This banking institution is not eligible to receive payments |
| DBA_35 | The name must have at least 3 characters |
| DBA_41 | Bank ISPB is required and must have exactly 8 numbers |
| DBA_42 | This banking institution is not eligible to receive payments |
| DBA_44 | Destination Bank Account was provided with bank code and ISPB, please provide only one bank info |
| DBA_45 | Bank code or ISPB are required |
| DBA_48 | Inconsistency in the registration status of the document |
Chave Pix
| Código | Mensagem |
|---|---|
| PIX_1 | Invalid PIX key type |
| PIX_2 | The email must be valid |
| PIX_4 | The phone number must be valid |
| PIX_15 | Pix key not found |
| PIX_28 | Format of EVP key is invalid |
| PIX_29 | Inconsistency in the registration status of the document |
| PIX_33 | The document format is invalid |
| PIX_34 | Document does not exist |
| PIX_35 | Informed document is divergent from Pix key owner |
| PIX_36 | Invalid phone key area code |
| PIX_56 | The informed Pix key is blocked for receiving payments. |
Transações
Novo formato de códigos de erros. retornado especificamente para as validações do tipo micro depósito.
| Código | Mensagem |
|---|---|
| failed | An error has occurred. |
| receiver_account_invalid | Receiver account is invalid. |
| receiver_account_type_invalid | Receiver account type is invalid. |
| receiver_account_blocked | Receiver account is blocked. |
| receiver_account_closed | Receiver account is closed. |
| receiver_account_limit_exceeded | Receiver account limit exceeded. |
| receiver_account_not_allowed_payment | Receiver account does not allow this type of payment. |
| receiver_institution_failure | Transaction aborted due to failure on receiver institution. |
| receiver_institution_not_enabled | Receiver institution is not enabled within the payment system. |
| receiver_tax_id_divergent | Receiver tax id is divergent with account tax id. |
| ted_refunded_document_is_divergent | TED refunded by bank, CPF/CNPJ is divergent. |
| invalid_account_type_or_external_payment_not_allowed | Invalid account type and/or not allowed to receive external payments. |
| receiver_institution_qrcode_rejected | QR Code rejected by the receiver institution. |
| receiver_institution_rejected_payment | Rejected by receiver bank. |
| receiver_institution_rejected_payment_antifraud | Rejected by receiver bank for security reasons. |
| receiver_tax_id_legal_issues | Receiver document is blocked and can not receive payments. |
| antifraud_refused | Transaction declined for security reasons. |
| transfer_failed_after_retries | After a few attempts, we were unable to send the transfer to the destination bank. |
| operation_cancelled_manually | Operation canceled manually. |
| transaction_not_allowed_for_third_party_account | Transaction is not allowed for third party account. |
| dict_access_restricted | Access to DICT is restricted for security reasons. |
| operation_not_allowed | Operation not allowed. |
HTTP status codes
| Código | Descrição |
|---|---|
| 200 | OK |
| 201 | Created |
| 204 | No Content |
| 400 | Requisição inválida |
| 401 | Não autenticado |
| 403 | Não autorizado |
| 429 | Too Many Requests |
| 5xx | Ocorreu algum erro interno no servidor. Consulte a página de status para mais informações: https://status.transfeera.com/ |