Rate limit

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
TRA_30	The payer account limit has been exceeded for this transaction
TRA_31	Recurrent payment cannot be updated to Pix copy and paste (emv)
TRA_32	Expired payment

📘

* Valor padrão de limite configurado na sua conta é de R$ 25.000,00, se precisar de mais limite contate a Transfeera pelo suporte@transfeera.com* ** 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$ )
BAT_9	There is another operation currently changing this batch in parallel and the change has not been applied.
BAT_10	The batch cannot be canceled
BAT_11*	The batch amount is greater than the nightly limit allowed (R$ )
BAT_12*	The batch amount is greater than the weekend limit allowed (R$ )

📘
* Caso queira consultar seu limite diário ou tenha a necessidade de aumentá-lo contate a Transfeera pelo suporte@transfeera.com

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 suporte@transfeera.com.

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
BIL_26	More than max limit billets have been identified. Try applying more filters and try again.
BIL_27	It was not possible to make the payment as the billet has interest or discount. Consult the billet data again to get the updated value.
BIL_28	It was not possible to make the payment. Billet was already paid or downloaded.
BIL_29	It was not possible to make the payment. Agreement not accepted.
BIL_30	Billet with registration discrepancy. Unable to calculate interest/fine.
BIL_31	Billet returned by compensation.
BIL_32	It was not possible to make the payment. Payment not allowed.

📘

* Caso queira consultar o limite ou tenha a necessidade de aumentá-lo, contate a Transfeera pelo suporte@transfeera.com.* ** 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_24	Pix returned
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
PIX_52	DICT query bucket quota exceeded
PIX_53	The account holder's document has pending issues with the Receita Federal
PIX_54	Request rejected in accordance with the institution's security policies
PIX_55	Pix blocked for partial refunds due to a precautionary hold
PIX_56	The informed Pix key is blocked for receiving payments
PIX_57	Pix key of type email cannot be registered or claimed as it is already linked to another document

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_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.

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