Error handling

There are two stages at which an error code can be generated.

• Firstly, after creating a transaction, if it does not pass our pre-validation checks for data field formats, limits, and KYC, the status will be "LockDeclined".

• Secondly, after settling a payment with all pre-validations cleared, the paying bank may still decline the payment due to a deeper validation error, such as the account number not belonging to the beneficiary, the status will be "Reversed".

Error Codes

All codes are designed to be self-explanatory; however, we are happy to provide further clarification if needed.

Lock declined codes

Error codes will appear in the parameters "LockDeclineReason" and "LockDeclineReasonDescription".

LockDeclineReason	LockDeclineReasonDescription
1	SENDING_AMOUNT_WOULD_EXCEED_TRANSACTION_AMOUNT_LIMIT
2	SENDER_SANCTION_LIST_HIT
3	RECIPIENT_SANCTION_LIST_HIT
4	SENDER_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED
5	RECIPIENT_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED
6	SENDER_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED
7	RECIPIENT_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED
8	SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT
9	RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT
10	SENDER_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT
11	RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT
12	SENDER_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED
13	RECIPIENT_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED
14	SENDER_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED
15	RECIPIENT_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED
16	SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT
17	RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT
18	SENDER_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT
19	RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT
20	SENDER_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED
21	RECIPIENT_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED
22	SENDER_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED
23	RECIPIENT_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED
24	SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT
25	RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT
26	SENDER_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT
27	RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT
28	COMPANY_NOT_IN_WHITELIST
29	SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_BENEFICIARY_LIMIT
30	SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_SENDER_LIMIT

Reverse error codes