Skip to main content

Payout General Cancelled Errors

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":"INCORRECT_CUSTOMER_DATA",
  "message":"Incorrect customer data",
  "gateway_details": "20-08A: iDato no encontrado!"
}

The gateway_details field contains the exact response from the provider, useful for deeper analysis in special cases.

CodeError messageMerchant's action required
TAX_ID_MISMATCHThe bank details don't belong to the CPF/CNPJ informedConfirm the bank account details with the recipient, ensuring they match the provided tax ID exactly.
INCORRECT_CUSTOMER_DATAThe bank account, bank branch and/or pix_key is invalid or non existentSince the provider doesn’t specify which field is incorrect, ask the recipient to verify and resend all banking details exactly as shown in their bank app.
ACCOUNT_BLOCKEDThe bank account informed is currently blocked and unable to receive transfersAsk the recipient to check with their bank. If the account is unblocked, the payout can be retried.
UNSUPPORTED_TRANSACTIONThis bank account doesn't accept this type of transactionThe bank rejected the transaction. Only the recipient can contact their bank for more information or provide a different account.
ACCOUNT_DOESNT_EXISTSThis bank account is closed and unable to receive transfersAsk the recipient to provide an alternative, active bank account.
HIGH_RISKThe payout amount is higher than the accepted by the receiver's bankAsk the recipient to check with their bank. Alternatively, split the payout into smaller amounts.
DECLINEDThe receiver's bank rejected the transactionThe bank provided no reason for the rejection. Request another account from the recipient or have them follow up with their bank.
TIMEOUTReceiver's bank timeout, please send the transaction againRetry the transaction. No data changes are required unless confirmed by the recipient.
INCORRECT_ACCOUNT_TYPEThe account type informed is incorrectResend the payout with the correct account type: C for Checking or S for Savings.
PIX_NOT_ACCEPTEDThe bank informed doesn't support pix transactionsIf only a Pix key was provided, request full bank details and use the bank_account target type instead.
RESPONSE_ERRORUnknown errorAn unexpected error occurred. Retry the payout or contact EBANX support if the issue persists.
REJECTEDPayout rejected by the receiving methodRetry the payout. EBANX is working with the provider to gather more information.
FRAUD_RISKThe pix key informed is considered fraudulent by the Central Bank of BrazilThe Pix key is blocked and cannot receive payouts. Request a different payment method from the recipient.

Canceled error codes may be updated as new errors are identified or provider responses change. EBANX will notify merchants before adding new codes and will keep this page up to date.

Still need help?

Help Image

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