Error codes range

Different error codes types can be seen below.

Code range	Description
3xxx	Syntax validation in parameter/s.
4xxx	Merchant identification validation.
5xxx	Business logic validation.
7xxx	Transactional error.

HTTP Error codes

All errors are returned with the appropriate HTTP status code, either 4xx or 5xx. The format of all errors is:

Property	Type	Description
`code`	Integer	Error code.
`message`	String	Human readable message.
`param`	String	In case one parameter is invalid or missing.

Error codes and HTTP status

HTTP Status	Code	Description
`400 Bad Request`	3000	Invalid params + [param name] + [reason]
`400 Bad Request`	3001	Empty params + [param name]
`400 Bad Request`	3003	Invalid bank code.
`403 Forbidden`	4001	Invalid credentials.
`403 Forbidden`	4002	Unregistered IP address (register is in Merchant Dashboard).
`400 Bad Request`	5007	Country not found for payouts.
`400 Bad Request`	5008	Limit exceeded + [limit name].
`400 Bad Request`	5009	Payout not found with this ID.
`400 Bad Request`	5010	Invalid status: payout is not pending.
`400 Bad Request`	5011	External ID already used.
`400 Bad Request`	5012	Rejected compliance limits.
`400 Bad Request`	5013	End beneficiary blacklisted.
`400 Bad Request`	5014	Insufficient funds.
`400 Bad Request`	5015	Rejected due to compliance.
`400 Bad Request`	7002	Could not cancel the payout.
`500 Internal Server Error`	7003	Failed to process the request.
`400 Bad Request`	7004	Could not release the payout due to compliance.

Rejection Error Codes

When a payout is rejected post its creation, the rejection code will be displayed at field status_code while making a GET Payout or at the asynchronous notification (IPN).

Code range	Description
320	Account number incorrect.
301	Account is closed.
302	Amount incorrect or invalid for the account.
303	Invalid or unsupported bank code.
304	Bank branch incorrect.
305	Beneficiary document ID invalid.
306	Beneficiary name incorrect or mismatch.
307	Rejected by the beneficiary bank.
308	Rejection reason other/unspecified.
309	Account type incorrect for the transaction.
310	Account does not match beneficiary document.
311	Account does not match beneficiary name.
312	Account does not accept transfers.
313	Beneficiary document not match name.
314	Account of other currency.
315	The payout has been rejected due to compliance reasons.
316	The beneficiary is prohibited to receive payouts due to compliance reasons.
317	Rejected post approval.
318	Wallet key not supplied.
319	Incorrect wallet key.
332	External payment network service is temporarily unavailable.