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.
Error codes will appear in the parameters "LockDeclineReason" and "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
Last updated