Error codes for transfer dispersions

Learn about common mistakes in money transfer dispersals

When making a transfer disbursement request you can check the transaction status through the Get Status endpoint or via a webhook. If there is a problem completing the disbursement, you will receive an error code along with a message containing the error information. The fields you will receive in the response are the following:

"responseCode": "076",
"responseText": "Error processing the payment."

Bank account (ACH)

Below are the codes you may receive for bank account disbursements:

Error codeDescription
052Invalid account number
067Invalid NIT
068Invalid amount
68Invalid amount
069Invalid product
69Invalid product
070Invalid account type
071Invalid transfer amount
072Bank not enabled
073Transaction not permitted
074Bank or account not registered
075Invalid account class
076Error processing the payment
077Pending response from other banks
078Blocked account
079Cancelled account
080Invalid destination account
081Transfer to the same account
082Seized account
083Settled account
084Expired account
085Checking account does not exist
086Only allows deposits to AFC account
087Account blocked due to death
088Account does not exist
089Active official account
090Account not enabled
091Account with transaction block
002An unexpected error occurred
041A system error occurred and your payment could not be processed. Please try again

Bre-B

Bre-B errors are grouped into three categories depending on when they occur in the flow.

Key validation errors

These occur during the tokenization step, before the transaction is initialized.

Error codeDescription
PT060The provided payment key does not exist or is not valid
PT001Invalid request body
PT057The currency sent differs from the one defined by the processor

Processing errors

These occur during the transfer process, once the transaction has been initiated.

Error codeDescription
041A system error occurred and your payment could not be processed. Please try again
045Insufficient funds
068Invalid amount
071Invalid transfer amount
072Bank not enabled
073Transaction not permitted
074Bank or account not registered
076Error processing the payment
077Pending response from other banks
002An unexpected error occurred

Receiving bank errors

Returned by the recipient’s bank when attempting to credit the funds.

Error codeDescription
052Invalid account number
067Invalid NIT
070Invalid account type
080Invalid destination account
088Account does not exist
091Account with transaction block