Error codes

The error code shown when a payout fails.

Error codes range

Different error codes types can be seen below.

Code rangeDescription
3xxSyntax validation in parameter/s.
4xxMerchant identification validation.
5xxBusiness logic validation.
6xxSemantic validation in parameter/s.
7xxTransactional error.
8xxRejection error (only API Version 2.0).

Syntax codes reference

CodeDescription
300Invalid params + [param name] + [reason]
301Empty params + [param name]
302Invalid control string.
303Invalid bank code.

Merchant identification validation

CodeDescription
401Invalid credentials.
402Unregistered IP address (register is in Merchant Dashboard).

Business logic validation

CodeDescription
507Country not found for payouts.
508Limit exceeded + [limit name]
509Payout not found with this ID.
510Invalid status: payout is not Pending.
511External ID already used.
512Rejected compliance limits.
513End beneficiary blacklisted.
514Insufficient funds.
515Rejected due to compliance.

Transactional error

CodeDescription
702Could not cancel the payout.
703Could not make the payout.
704Could not release the payout due to compliance.

Rejection error

CodeDescription
800ERROR_ACCOUNT_INCORRECT
801ERROR_ACCOUNT_CLOSED
802ERROR_AMOUNT_INCORRECT
803ERROR_BANK_INVALID
804ERROR_BANK_BRANCH_INCORRECT
805ERROR_BENEFICIARY_DOCUMENT_ID_INVALID
806ERROR_BENEFICIARY_NAME_INCORRECT
807ERROR_REJECTED_BY_BANK
808ERROR_OTHER
809ERROR_ACCOUNT_TYPE_INCORRECT
810ERROR_ACCOUNT_NOT_MATCH_BENEFICIARY_DOCUMENT
811ERROR_ACCOUNT_NOT_MATCH_BENEFICIARY_NAME
812ERROR_ACCOUNT_NOT_ACCEPT_TRANSFERS
813ERROR_BENEFICARY_DOCUMENT_NOT_MATCH_NAME
814ERROR_ACCOUNT_OF_OTHER_CURRENCY
815ERROR_REJECTED_BY_COMPLIANCE
816ERROR_REJECTED_BENEFICIARY_BLACKLISTED
817REJECTED_POST_APPROVAL
818ERROR_WALLET_KEY_NOT_SUPPLIED
819ERROR_INCORRECT_WALLET_KEY
832NETWORK_SERVICE_UNAVAILABLE

How can we improve?

Let’s collaborate to create a better experience.

Give feedback