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 |