ISO 20022 Academy
ISO 20022 code set

Reason codes

Why a payment was rejected, returned or refused. The family prefix (AC/AM/AG/RR/MD) tells you where the problem lives.

Open in the interactive Academy →

Carried in: Rsn/Cd — in reject, return, status and cancellation messages

A common selection of the External Status/Return/Cancellation reason sets. The full lists are larger and updated quarterly.

CodeNameMeaning
AC01IncorrectAccountNumberThe account number is invalid or malformed.
AC03InvalidCreditorAccountNumberThe creditor account number is invalid.
AC04ClosedAccountNumberThe account is closed. Terminal — no retry will succeed.
AC06BlockedAccountThe account is blocked; posting is not allowed.
AG01TransactionForbiddenThis transaction type is not allowed for the agent.
AG02InvalidBankOperationCodeThe bank operation / transaction code is invalid.
AM04InsufficientFundsNot enough money on the account to make the payment.
AM05DuplicationDuplicate payment — do not blindly retry, it may already exist.
AM09WrongAmountThe amount is not the amount that was agreed or expected.
BE01InconsistentWithEndCustomerDebtor/creditor details are inconsistent with the end customer.
BE04MissingCreditorAddressThe creditor address is missing or incomplete.
BE06UnknownEndCustomerThe end customer is not known to the bank.
DT01InvalidDateA date (e.g. requested execution/settlement) is invalid.
FF01InvalidFileFormatThe file or message format is not valid.
MD01NoMandateNo valid mandate exists for the direct debit.
MD07EndCustomerDeceasedThe debtor is deceased.
RC01BankIdentifierIncorrectThe BIC / bank identifier is incorrect.
RR01MissingDebtorAccountOrIdRegulatory: debtor account or identification is missing.
RR03MissingCreditorNameOrAddressRegulatory: creditor name or address is missing.
RR04RegulatoryReasonHeld or rejected for a regulatory/compliance reason. Slow to resolve.
TM01CutOffTimeReceived after the cut-off time for the requested settlement.
NOORNoOriginalTransactionNo original transaction found (e.g. for a return) / not our customer.
NARRNarrativeReason given as free text — the escape hatch. A smell when a real code existed.
DUPLDuplicatePaymentCancellation: a duplicate payment was sent.
FRADFraudulentOriginCancellation: fraud suspected — freeze and return.
TECHTechnicalProblemCancellation: a technical error in the original instruction.
CUSTRequestedByCustomerCancellation: the customer requested it.
AGNTIncorrectAgentCancellation: wrong agent / routing error.
UPAYUnduePaymentCancellation: the payment should not have been made.
Part of the ISO 20022 Dictionary — the reference layer of ISO 20022 Academy. Written by Revanth Sai Rayapati.