As chamadas das APIs para os endpoints POST, PATCH,PUT,DELETE possuem um rate limit de 100 requisições por segundo. Para os endpoints GET, HEAD e OPTIONS o rate limit é de 40 RPS. Caso esse limite seja atingido você receberá um retorno de um erro com HTTP status code 429.
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.
path: Expressão JSONPath indicando qual atributo, elementos aninhados ou matrizes do documento JSON do payload causou o 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,
"path": "$.transfers[0].destination_bank_account.account"
}
Destination Bank Account (DBA)
Código
Mensagem
DBA_1
Agency digit must be numeric or x
DBA_2
Account digit is required and must be numeric or x
DBA_3
Agency must be 1
DBA_4
Agency is required and must contain a maximum of numbers
DBA_5
Agency digit must be only 1 digit
DBA_6
Account is required and must have a maximum of numbers
DBA_7
Account is required and must have between and numbers
DBA_8
Account digit is required and must be only 1 digit
DBA_9
Account is required and must contain exactly numbers
DBA_10
Invalid account type
DBA_11
Account type 'Entidade pública' is only available for CNPJ
DBA_12
Destination bank account document is not a CPF nor CNPJ
DBA_13
Destination bank account document is blocked
DBA_14
Bank(s) not found by id
DBA_15
The Name must have at least 2 words
DBA_16
The email must be valid
DBA_17
Destination Bank Account cannot be edited when status is Pending Verification or Verified
DBA_18
Destination Bank Account cannot be removed while having processing transfers
DBA_19
Invalid agency digit
DBA_20
Invalid account digit
DBA_21
Invalid account
DBA_22
Agency does not exist
DBA_23
Document does not exist
DBA_24
Informed document does not match with informed name
DBA_25
Payload is required
DBA_26
Invalid account. Account beginning is not valid
DBA_27
Invalid legal document
DBA_28
Invalid physical document
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_36
Bank ID must be a number
DBA_37
The PIX key type is required
DBA_38
The PIX key value is required
DBA_39
The PIX key type is invalid
DBA_40
The PIX key value is invalid for the key type
DBA_41
Bank ISPB is required and must have exactly 8 numbers
DBA_42
This banking institution is not eligible to receive payments
DBA_43
This banking institution is only eligible to receive payments using Pix
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_46
Destination Bank Account was provided with bank id and ISPB, please provide only one bank info
DBA_47
This banking institution is only eligible to receive payments using TED/TEV
Transferências
Código
Mensagem
TRA_1
Transfer value can not be R$0,00
TRA_2*
Transfer value for this bank can not be greater than R$
TRA_3
Wrong format of a transfer field content
TRA_4
Payment date before current date
TRA_6
TED schedules for today are allowed until 4:30PM
TRA_7
You can not schedule a transfer after 30 days
TRA_8
We process transfers only on business days, you need to change the date to a business day
TRA_9
Wrong payment date format
TRA_10**
You have payments that will be made on the next business day
TRA_11
Duplicated integration id
TRA_12
Destination bank account is removed
TRA_13
Invalid payment method
TRA_14
You cannot schedule a PIX payment with key
TRA_15
Transfer value can not exceed 2 decimal places
TRA_16
The length of the pix description cannot be longer than 140 characters
TRA_17
The pix description cannot contain unsafe html tags
TRA_19
Invalid idempotency key
TRA_20
Transfer(s) with duplicated idempotency key (list of duplicated idempotency keys separated by comma)
TRA_21
Invalid Pix copy and paste (emv)
TRA_22
Unable to find Pix copy and paste (emv) data
TRA_23
Invalid city code
TRA_24
Pix copy and paste (emv) already paid
TRA_25
Pix copy and paste (emv) removed by the receiver
TRA_26
The entered amount differs from the charge amount
TRA_27
Due date collection payments are not supported
TRA_28
Expired Pix copy and paste (emv)
TRA_29
Pix change and Pix withdraw are not supported
📘
* Valor padrão de limite configurado na sua conta é de R$ 25.000,00, se precisar de mais limite contate a Transfeera pelo [email protected]
** Esse é um erro do tipo alerta
Lote
Código
Mensagem
BAT_1
Your batch has no transfers, register transfers to close it.
BAT_3
The batch type must be "TRANSFERENCIA" or "BOLETO".
BAT_4
Invalid batch name.
BAT_5
The current batch status does not allow updates. Changes are only allowed in the reconciled field
BAT_6
The batch cannot have more than 10.000 payments (transfers/billets)
BAT_7*
The batch amount is greater than the daily limit allowed (R$ )
BAT_8*
Payments scheduled for the day DD/MM/YYYY are greater than the daily limit allowed (R$ )
📘
* Caso queira consultar seu limite diário ou tenha a necessidade de aumentá-lo contate a Transfeera pelo [email protected]
Saldo/Extrato
Código
Mensagem
STA_1
Your balance is insufficient.
STA_2
Enter the amount to withdraw.
Sistema
Código
Mensagem
SYS_1*
An error has occurred
📘
* Se este erro ocorrer, contate a Transfeera pelo [email protected].
Boletos
Código
Mensagem
BIL_1
Processing hour outside allowed range, we process billets until 6:00pm
BIL_2
Payment date can not be after due date
BIL_3
Invalid barcode
BIL_4*
Value greater than allowed
BIL_5
Value not allowed
BIL_6
Billet expired
BIL_7
We process billets only on business days, you need to change the date to a business day
BIL_8
Duplicated barcode
BIL_9
Payment date is required
BIL_10
Wrong format to payment date
BIL_11
Payment date before current date
BIL_12
Your batch has no billets, register billets to close it
BIL_13
Wrong format of a billet field content
BIL_14
Duplicated integration id
BIL_15
You can not schedule a billet after 30 days
BIL_16
Billet value must be greater than R$0,00
BIL_17
Billet barcode or digitable line are invalid
BIL_18
Billet not registered
BIL_19
Could not find billet
BIL_20
Billet exceeded the payment deadline
BIL_21
Billet has already been paid, it is not possible to consult
BIL_22**
Billet available for payment
BIL_23
Can't schedule payment of overdue billets
BIL_24
To pay overdue billets or billets with discount it is mandatory that you first consult the billet data in our API. This way we guarantee the correct amount, updated with fines, interest and discounts. See our documentation for more details.
BIL_25
Billet value can not exceed 2 decimal places
📘
* Caso queira consultar o limite ou tenha a necessidade de aumentá-lo, contate a Transfeera pelo [email protected].
** Este não é um erro, apenas uma informação.
Pix
Código
Mensagem
PIX_1
Invalid PIX key type
PIX_2
The email must be valid
PIX_3
Provided document is not a CPF nor CNPJ
PIX_4
The phone number must be valid
PIX_5
Provided PIX key already exists
PIX_6
Invalid verification code for PIX key
PIX_7
PIX key limit exceeded (20)
PIX_8
Invalid date format
PIX_9
The value must not be lower than R$ 0,00
PIX_10
The payer's type must be valid
PIX_11
The payer's document is not a CPF or CNPJ
PIX_12
The payer's name must be valid
PIX_13
The payer's email must be valid
PIX_14
The payer's phone number must be valid
PIX_15
Pix key not found
PIX_16
Unable to send PIX to salary account
PIX_17
Invalid date
PIX_18
This key is already registered and is in the process of being claimed. You will not be able to register it until the process is finished.
PIX_19
You cannot delete keys that are in the claim process. Wait for the process to complete
PIX_20
Key status does not allow to start a claim process
PIX_21
Key status does not allow to cancel the claim process
PIX_22
Key status does not allow to confirm the claim process
PIX_23
There is already an ongoing claim process for this key
PIX_25
After a few attempts, we were unable to send the transfer to the destination bank
PIX_26
QRCode data is duplicated
PIX_27
QRCode finished, can't be updated
PIX_37
The document format is invalid
PIX_38
It is not allowed to create fixed value splits for QRCodes when the parameter "value_change_mode" is "MODIFICAVEL"
PIX_39
Split(s) value exceeds QRCode value
PIX_40
Invalid QRCode value
PIX_41
Can't use both withdraw and change fields in the same QRCode
PIX_42
Description contains invalid characters
PIX_43
Key status does not allow removal
PIX_44
Expired end2end id, it cannot be used anymore for transaction processing
PIX_45
Duplicated end2end id, it was already used in another transaction ({{duplicatedEnd2endIds}})
PIX_46
Pix blocked for refunds because it is associated to a MED in progress
PIX_47
Invalid pix key format
PIX_48
Pix key was not registered as you can only register 5 keys in your account
PIX_49
Pix key of type {{key_type}} is not allowed for your account type
PIX_50
Informed Pix key {{key_type}} is divergent from the tax ID of the account owner
PIX_51
Limit of Pix key queries in DICT exceeded
Transações
Novo formato de códigos de erros (utilizado nas devoluções de cashins Pix e pós processamento de pagamentos)
Código
Descrição
failed
An error has occurred.
receiver_account_invalid
Receiver account 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.
