In case of an error return through our API call, we will structure the data in the following way:
| Attribute | Mandatory | Description |
|---|
| type | True | the type of error, can be one of FATAL, VALIDATION_FIELD, VALIDATION_GLOBAL |
| errorCode | True | the technical error code |
| message | True | a friendly message explaining the error |
| formObjectName | False | The object within the response |
| Field | False | The field in error |
The error codes for a FATAL PAC / PMC are defined below:
| Error code | Message |
|---|
| BAD_ACCOUNT_NUMBER | Bad account number. |
| CARD_EXPIRED | Invalid card expiry date - {0} |
| EXPIRY_DATE_FUTURE | Invalid card expiry date {0} - Expiry date must be in the next {1} years |
| OPERATION_NOT_POSSIBLE | PAC currency of the amount has to be the same as the currency of the source account |
| TRANSACTION_FAILED | Cannot find card details |
| OPERATION_NOT_POSSIBLE | Operation not possible due to {0} |
| ELEMENT_NOT_FOUND | Element {0} with id {1} not found. |
| ELEMENT_NOT_FOUND | Card holder nationality may not be empty |
| ELEMENT_NOT_FOUND | Card name may not be empty |
| TRANSACTION_FAILED | Cannot find card details |
| TRANSACTION_FAILED | Processor sends the error code and message |
| TRANSACTION_FAILED | Transaction Declined: {0}, reason: Invalid data for queue processing |
| UNSUPPORTED_CURRENCY | Currency {} is not supported by the system! |
| ACCOUNT_DISABLED | Account {0} is disabled. |
| INSUFFICIENT_FUNDS | You have insufficient funds in your eWallet. Please top up your eWallet account. |
| ACCESS_DENIED | Cannot perform this action. Access denied |
| BLACKLISTED | Card BIN is blacklisted |
| BLACKLISTED | Card scheme not permitted |
| BLACKLISTED | We are unable to process transactions for this card |
| INVALID_DATA_FORMAT | Invalid card number. |
| VALIDATION | {} |
| ErrorCode | Message |
|---|
| 01001 | Invalid credit card number |
| 01002 | Must be a valid expiry date. |
| 01003 | Description size must be between 1 and 25 |
| 01004 | Invalid currency {} |
| 01005 | Unsupported currency – {} |
| ErrorCode | Message |
|---|
| DAILY_VELOCITY_EXCEEDED | Daily velocity exceeded |
| WEEKLY_VELOCITY_EXCEEDED | Weekly velocity exceeded |
| MONTHLY_VELOCITY_EXCEEDED | Monthly velocity exceeded |
| OPERATION_NOT_POSSIBLE | Velocities: Zero amount |