# 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.

{% tabs %}
{% tab title="Lock declined codes" %}
Error codes will appear in the parameters "LockDeclineReason" and "LockDeclineReasonDescription".

<table><thead><tr><th width="192">LockDeclineReason</th><th width="476">LockDeclineReasonDescription</th></tr></thead><tbody><tr><td>1</td><td>SENDING_AMOUNT_WOULD_EXCEED_TRANSACTION_AMOUNT_LIMIT</td></tr><tr><td>2</td><td>SENDER_SANCTION_LIST_HIT</td></tr><tr><td>3</td><td>RECIPIENT_SANCTION_LIST_HIT</td></tr><tr><td>4</td><td>SENDER_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>5</td><td>RECIPIENT_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>6</td><td>SENDER_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>7</td><td>RECIPIENT_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>8</td><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>9</td><td>RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>10</td><td>SENDER_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>11</td><td>RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>12</td><td>SENDER_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>13</td><td>RECIPIENT_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>14</td><td>SENDER_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>15</td><td>RECIPIENT_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>16</td><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>17</td><td>RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>18</td><td>SENDER_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>19</td><td>RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>20</td><td>SENDER_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>21</td><td>RECIPIENT_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>22</td><td>SENDER_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>23</td><td>RECIPIENT_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>24</td><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>25</td><td>RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>26</td><td>SENDER_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>27</td><td>RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>28</td><td>COMPANY_NOT_IN_WHITELIST</td></tr><tr><td>29</td><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_BENEFICIARY_LIMIT</td></tr><tr><td>30</td><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_SENDER_LIMIT</td></tr></tbody></table>
{% endtab %}

{% tab title="Reverse error codes" %}
Error codes will appear in the parameter "ReverseReason"

<table><thead><tr><th width="715">ReverseReason</th></tr></thead><tbody><tr><td>ERROR_BENEFICARY_DOCUMENT_NOT_MATCH_NAME</td></tr><tr><td>ERROR_BENEFICIARY_ADDRESS_INVALID</td></tr><tr><td>ERROR_BENEFICIARY_DOCUMENT_ID_INVALID</td></tr><tr><td>ERROR_BENEFICIARY_NAME_INCORRECT</td></tr><tr><td>ERROR_BENEFICIARY_PHONE_NUMBER_INVALID</td></tr><tr><td>ERROR_MISSING_BENEFICIARY_ADDRESS</td></tr><tr><td>ERROR_MISSING_BENEFICIARY_NAME</td></tr><tr><td>ERROR_MISSING_SENDER_ADDRESS</td></tr><tr><td>ERROR_MISSING_SENDER_NAME</td></tr><tr><td>ERROR_SENDER_ADDRESS_INVALID</td></tr><tr><td>ERROR_SENDER_ADRESS_DESCRIPTION</td></tr><tr><td>ERROR_SENDER_ADRESS_INVALID</td></tr><tr><td>ERROR_SENDER_BIRTH_DATE</td></tr><tr><td>ERROR_SENDER_CITY</td></tr><tr><td>ERROR_SENDER_COUNTRY</td></tr><tr><td>ERROR_SENDER_EMAIL</td></tr><tr><td>ERROR_SENDER_EMAIL_ADDRESS_INVALID</td></tr><tr><td>ERROR_SENDER_IDENTIFICATION_NUMBER</td></tr><tr><td>ERROR_SENDER_IDENTIFICATION_TYPE</td></tr><tr><td>ERROR_SENDER_LAST_NAME</td></tr><tr><td>ERROR_SENDER_NAME</td></tr><tr><td>ERROR_SENDER_NAME_INVALID</td></tr><tr><td>ERROR_SENDER_POSTALCODE</td></tr><tr><td>ERROR_UNKNOWN_BENEFICIARY</td></tr><tr><td>MISSING_RECIPIENT_ACCOUNT_TYPE</td></tr><tr><td>MISSING_RECIPIENT_DOCUMENT_COUNTRY</td></tr><tr><td>MISSING_RECIPIENT_PHONE_NUMBER</td></tr><tr><td>RECIPIENT_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>RECIPIENT_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>RECIPIENT_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>RECIPIENT_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>RECIPIENT_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>RECIPIENT_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>RECIPIENT_SANCTION_LIST_HIT</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_BENEFICIARY_LIMIT</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_SENDER_LIMIT</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>SENDER_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>SENDER_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>SENDER_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED</td></tr><tr><td>SENDER_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT</td></tr><tr><td>SENDER_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT</td></tr><tr><td>SENDER_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT</td></tr><tr><td>SENDER_SANCTION_LIST_HIT</td></tr><tr><td>BENEFICIARY_AML_WARNING</td></tr><tr><td>INVALID_ACCOUNT_BENEFICIARY </td></tr><tr><td>INVALID_ACCOUNT_BENEFICIARY_ID </td></tr><tr><td>INVALID_ACCOUNT_CURRENCY </td></tr><tr><td>INVALID_ACCOUNT_NUMBER </td></tr><tr><td>INVALID_ACCOUNT_STATUS </td></tr><tr><td>INVALID_ACCOUNT_DETAILS</td></tr><tr><td>INVALID_ACCOUNT_NUMBER</td></tr><tr><td>ERROR_ACCOUNT_CLOSED</td></tr><tr><td>ERROR_ACCOUNT_INCORRECT</td></tr><tr><td>ERROR_ACCOUNT_NOT_ACCEPT_TRANSFERS</td></tr><tr><td>ERROR_ACCOUNT_NOT_MATCH_BENEFICIARY_DOCUMENT</td></tr><tr><td>ERROR_ACCOUNT_NOT_MATCH_BENEFICIARY_NAME</td></tr><tr><td>ERROR_ACCOUNT_OF_OTHER_CURRENCY</td></tr><tr><td>ERROR_ACCOUNT_TYPE_INCORRECT</td></tr><tr><td>CANCELLED_BY_USER</td></tr><tr><td>CANCELLED_REFUND_TO_AGENCY</td></tr><tr><td>CANCELLED_REFUND_TO_CUSTOMER</td></tr><tr><td>ERROR</td></tr><tr><td>ERROR_AMOUNT_INCORRECT</td></tr><tr><td>ERROR_BANK_BRANCH_INCORRECT</td></tr><tr><td>ERROR_INVALID_AMOUNT</td></tr><tr><td>ERROR_PAYOUT_DATE</td></tr><tr><td>ERROR_REJECTED_BENEFICIARY_BLACKLISTED</td></tr><tr><td>ERROR_REJECTED_BY_REGULATORY_REASON</td></tr><tr><td>Transaction rejected</td></tr><tr><td>TRANSACTION_DUPLICATED</td></tr><tr><td>TRANSACTION_MISSING</td></tr><tr><td>TRANSACTION_PAID</td></tr><tr><td>TRANSACTION_PROCESSING</td></tr><tr><td>TRANSACTION_REVERSED</td></tr><tr><td>TRANSACTION_SENT</td></tr><tr><td>TRANSACTION_UNHOLD</td></tr><tr><td>INVALID_BANK</td></tr><tr><td>INVALID_BANK_ALIAS_KEY</td></tr><tr><td>INVALID_BANK_ALIAS_VALUE</td></tr><tr><td>INVALID_CHARACTER_SET</td></tr><tr><td>PAYER TEMPORARILY UNAVAILABLE </td></tr><tr><td>PAYER_TEMPORARILY_UNAVAILABLE</td></tr><tr><td>TXIDENTIFIER_CANCELLED</td></tr><tr><td>SENDING_AMOUNT_WOULD_EXCEED_TRANSACTION_AMOUNT_LIMIT</td></tr><tr><td>LIMIT_EXCEEDED</td></tr><tr><td>COMPANY_NOT_IN_WHITELIST</td></tr><tr><td>COULD_NOT_MAKE_PAYOUT</td></tr><tr><td>CREDIT_REJECTED_BY_PARTNER</td></tr><tr><td>EXPIRED </td></tr><tr><td>REVERSE</td></tr><tr><td>Unsupported BIC XXXXXXX</td></tr><tr><td>PAYMENT EXPIRED</td></tr><tr><td>PAYMENT_EXPIRED</td></tr><tr><td>DECLINED</td></tr><tr><td>ERROR_BENEFICIARY_EMAIL_ADDRESS_INVALID</td></tr><tr><td>ERROR_BANK_INVALID</td></tr><tr><td>INVALID ACCOUNT BENEFICIAR</td></tr><tr><td>ERROR_REJECTED_BY_BANK</td></tr></tbody></table>
{% endtab %}
{% endtabs %}