Payout Canceled Errors for Remittance Brazil

This page lists the error codes that may occur during the payout creation process.

How it works

When an API call fails, EBANX will return a JSON object containing the error details.

Error object

If an API call fails, EBANX returns a JSON response with error details. The following key-value pairs exist with each error response.

{
  "code":"TAX_ID_MISMATCH",
  "message":"Document informed not accepted",
  "gateway_details":"Receiver's tax ID (CPF or CNPJ) doesn't match bank details"
}

The gateway_details shows a more detailed explanation of the error that we received by the bank, to help identify the better way to resolve the case.

Code	Error message (Gateway details)
ACCOUNT_BLOCKED	Blocked account
ACCOUNT_DOESNT_EXISTS	Account number inexistent
BANK_INFO	The bank branch is incorrect
BANK_INFO	The bank number is incorrect
BANK_INFO	The account number is incorrect
BANK_INFO	The receiver name is incorrect or missing
BANK_INFO	The account number or bank branch is incorrect
BANK_INFO	This banking information belongs to a different tax ID (CPF or CNPJ)
INCORRECT_ACCOUNT_TYPE	Invalid account type
REJECTED_BY_BANK	Transfer refused by the bank
SERVICE_UNAVAILABLE	The receiver's bank is unavailable at the moment
TAX_ID_MISMATCH	Receiver's tax ID (CPF or CNPJ) doesn't match bank details
TAX_ID_MISMATCH	Invalid document number

Note: A single error code may return different error messages depending on the provider’s response.

Canceled error codes may be updated if new errors are introduced or provider responses change. EBANX will notify merchants before adding new codes and will keep this page current.

Still need help?

We hope this article was helpful. If you still have questions, you can explore the following options:

• Merchant support: Contact our support team at sales.engineering@ebanx.com for assistance.
• Not a partner yet? Please complete the Merchant Signup Form, and our commercial team will reach out to you.