Remitee
  • Remitee API
  • Quick Start
    • Authentication
    • Step 1 - Create a quote
    • Step 2 - Accept a quote
    • Step 3 - Settle a payment
    • Step 4 - Get the payment status
  • Reference
    • API Reference
    • Error handling
    • Catalogs
      • ⭐UserInfo
        • Argentina
        • Bolivia
      • Payout methods
      • Banks
      • Documents
      • Contry codes
      • Currency codes
  • Integration Process
    • Integration process overview
    • Kickoff meeting
    • Fallow-up the integration progress
    • Suggested team you need
    • Gantt example
Powered by GitBook
On this page
  1. Reference

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

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

Error codes will appear in the parameter "ReverseReason"

ReverseReason

ERROR_BENEFICARY_DOCUMENT_NOT_MATCH_NAME

ERROR_BENEFICIARY_ADDRESS_INVALID

ERROR_BENEFICIARY_DOCUMENT_ID_INVALID

ERROR_BENEFICIARY_NAME_INCORRECT

ERROR_BENEFICIARY_PHONE_NUMBER_INVALID

ERROR_MISSING_BENEFICIARY_ADDRESS

ERROR_MISSING_BENEFICIARY_NAME

ERROR_MISSING_SENDER_ADDRESS

ERROR_MISSING_SENDER_NAME

ERROR_SENDER_ADDRESS_INVALID

ERROR_SENDER_ADRESS_DESCRIPTION

ERROR_SENDER_ADRESS_INVALID

ERROR_SENDER_BIRTH_DATE

ERROR_SENDER_CITY

ERROR_SENDER_COUNTRY

ERROR_SENDER_EMAIL

ERROR_SENDER_EMAIL_ADDRESS_INVALID

ERROR_SENDER_IDENTIFICATION_NUMBER

ERROR_SENDER_IDENTIFICATION_TYPE

ERROR_SENDER_LAST_NAME

ERROR_SENDER_NAME

ERROR_SENDER_NAME_INVALID

ERROR_SENDER_POSTALCODE

ERROR_UNKNOWN_BENEFICIARY

MISSING_RECIPIENT_ACCOUNT_TYPE

MISSING_RECIPIENT_DOCUMENT_COUNTRY

MISSING_RECIPIENT_PHONE_NUMBER

RECIPIENT_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED

RECIPIENT_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED

RECIPIENT_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED

RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT

RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT

RECIPIENT_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT

RECIPIENT_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED

RECIPIENT_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED

RECIPIENT_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED

RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT

RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT

RECIPIENT_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT

RECIPIENT_SANCTION_LIST_HIT

SENDER_DOCUMENT_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED

SENDER_DOCUMENT_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED

SENDER_DOCUMENT_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED

SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT

SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_BENEFICIARY_LIMIT

SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_ANNUAL_SENDER_LIMIT

SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT

SENDER_DOCUMENT_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT

SENDER_PHONE_NUMBER_ANNUAL_RECURRENCE_LIMIT_REACHED

SENDER_PHONE_NUMBER_DAILY_RECURRENCE_LIMIT_REACHED

SENDER_PHONE_NUMBER_MONTHLY_RECURRENCE_LIMIT_REACHED

SENDER_PHONE_NUMBER_WOULD_EXCEED_ANNUAL_AMOUNT_LIMIT

SENDER_PHONE_NUMBER_WOULD_EXCEED_DAILY_AMOUNT_LIMIT

SENDER_PHONE_NUMBER_WOULD_EXCEED_MONTHLY_AMOUNT_LIMIT

SENDER_SANCTION_LIST_HIT

BENEFICIARY_AML_WARNING

INVALID_ACCOUNT_BENEFICIARY

INVALID_ACCOUNT_BENEFICIARY_ID

INVALID_ACCOUNT_CURRENCY

INVALID_ACCOUNT_NUMBER

INVALID_ACCOUNT_STATUS

INVALID_ACCOUNT_DETAILS

INVALID_ACCOUNT_NUMBER

ERROR_ACCOUNT_CLOSED

ERROR_ACCOUNT_INCORRECT

ERROR_ACCOUNT_NOT_ACCEPT_TRANSFERS

ERROR_ACCOUNT_NOT_MATCH_BENEFICIARY_DOCUMENT

ERROR_ACCOUNT_NOT_MATCH_BENEFICIARY_NAME

ERROR_ACCOUNT_OF_OTHER_CURRENCY

ERROR_ACCOUNT_TYPE_INCORRECT

CANCELLED_BY_USER

CANCELLED_REFUND_TO_AGENCY

CANCELLED_REFUND_TO_CUSTOMER

ERROR

ERROR_AMOUNT_INCORRECT

ERROR_BANK_BRANCH_INCORRECT

ERROR_INVALID_AMOUNT

ERROR_PAYOUT_DATE

ERROR_REJECTED_BENEFICIARY_BLACKLISTED

ERROR_REJECTED_BY_REGULATORY_REASON

Transaction rejected

TRANSACTION_DUPLICATED

TRANSACTION_MISSING

TRANSACTION_PAID

TRANSACTION_PROCESSING

TRANSACTION_REVERSED

TRANSACTION_SENT

TRANSACTION_UNHOLD

INVALID_BANK

INVALID_BANK_ALIAS_KEY

INVALID_BANK_ALIAS_VALUE

INVALID_CHARACTER_SET

PAYER TEMPORARILY UNAVAILABLE

PAYER_TEMPORARILY_UNAVAILABLE

TXIDENTIFIER_CANCELLED

SENDING_AMOUNT_WOULD_EXCEED_TRANSACTION_AMOUNT_LIMIT

LIMIT_EXCEEDED

COMPANY_NOT_IN_WHITELIST

COULD_NOT_MAKE_PAYOUT

CREDIT_REJECTED_BY_PARTNER

EXPIRED

REVERSE

Unsupported BIC XXXXXXX

PAYMENT EXPIRED

PAYMENT_EXPIRED

DECLINED

ERROR_BENEFICIARY_EMAIL_ADDRESS_INVALID

ERROR_BANK_INVALID

INVALID ACCOUNT BENEFICIAR

ERROR_REJECTED_BY_BANK

PreviousAPI ReferenceNextCatalogs

Last updated 11 months ago