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. |
| 6xxx | Rejection errors |
| 7xxx | Transactional error. |
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. |
| 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. |
| Code range | Description |
|---|
| 6000 | Error: Account number incorrect. |
| 6001 | Error: Account is closed. |
| 6002 | Error: Amount incorrect or invalid for the account. |
| 6003 | Error: Invalid or unsupported bank code. |
| 6004 | Error: Bank branch incorrect. |
| 6005 | Error: Beneficiary document ID invalid. |
| 6006 | Error: Beneficiary name incorrect or mismatch. |
| 6007 | Error: Rejected by the beneficiary bank. |
| 6008 | Error: Rejection reason other/unspecified. |
| 6009 | Error: Account type incorrect for the transaction. |
| 6010 | Error: Account does not match beneficiary document. |
| 6011 | Error: Account does not match beneficiary name. |
| 6012 | Error: Account does not accept transfers. |
| 6013 | Error: Beneficiary document not match name. |
| 6014 | Error: Account of other currency. |
| 6017 | Rejected post approval. |
| 6018 | Error: Wallet key not supplied. |
| 6019 | Error: Incorrect wallet key. |
| 7005 | External payment network service is temporarily unavailable. |
