Payments Academy
FieldMeaningRequired
GrpHdrThe header with message identification, creation date and time and instructing agent. It identifies the status report for tracking and duplicate detection. The M
OrgnlGrpInfAndStsReference to the original message group plus its status and reason. It tells the sender whether the whole group was accepted, rejected or partially accepted. ThO
TxInfAndStsStatus information for a single transaction, with its identification, status and reason. It is the core of the message for exception handling. The sender uses iO
OrgnlInstrIdThe instruction identification from the original payment message, copied into the status report. It links the status to the sender instruction. The sender systeM
OrgnlEndToEndIdThe end to end identification from the original payment, copied into the status report. It stays unchanged through the chain and lets all banks and the customerO
OrgnlTxIdThe transaction identification from the original payment, assigned by the instructing agent. It provides a third matching key alongside instruction and end to eO
TxStsThe status of the transaction, using codes such as ACCP for accepted, RJCT for rejected, PDNG for pending, ACSC for accepted settlement completed and ACCC for aM
StsRsnInfThe reason for the status, with a coded reason and additional text. Codes include AC01 for wrong account number, AM05 for duplicate payment and NARR for a narraO
OrgnlIntrBkSttlmAmtThe interbank settlement amount from the original payment, copied into the status report. It confirms which payment the status refers to when several payments hO
OrgnlIntrBkSttlmDtThe interbank settlement date from the original payment, copied into the status report. It confirms the value date of the payment being reported on. The sender O
ChrgsInfCharges applied by the reporting agent, with amount, currency and bearer. It lets the sender see any fee deducted by an intermediary or the creditor agent. TranO
AccptncDtTmThe date and time when the reporting agent accepted the payment for processing. It is a key timestamp for gpi tracking and for measuring processing speed. The sO
Harbour Bank Singapore sends a pacs.002 to Meridian Bank London for the pacs.008 with end to end identification MER-20261105-1187: transaction status ACCP, accepted for processing. Meridian Bank updates its tracker and tells Bright Logistics the payment is on its way.

Valid example from the message catalogue. Scheme rules: pacs.002 is a base ISO 20022 message: the structure and fields below are the base definition, and each scheme adds its own rules for its rail. Under CBPR+ a pacs.002 must be sent for a rejected paymen

0:00 / 4:03 Step 1 of 5

ISO 20022 Messages and Reason Codes for Exceptions (pacs.002, pacs.004, camt.056, camt.029, pain.002 with real reason codes)

Payment Exceptions and Investigations, Lesson 6 of 7, Narration 4:03, D11 Operations, exceptions and reconciliation

ReconciliationISO 20022Exception

What you will learn

Your objective. By the end of this lesson, you will be able to explain ISO 20022 messages and reason codes for exceptions (pacs.002, pacs.004, camt.056, camt.029, pain.002 with real reason codes). The pacs.002 message, known as the payment status report, is the standard way for a bank to tell the sender whether a payment was accepted, rejected, or is still pending.

Why it matters. Common codes include AC01 for an incorrect account number, AC04 for a closed account, AM04 for insufficient funds, AM05 for a duplicate payment, and MD07 for an end customer who is deceased.

Chapter objective: Learner investigates payment exceptions, including non-receipt, wrong amount, duplicate, and delayed payments, and runs a structured investigation from first report to resolution. Learner demonstrates this skill using realistic banking examples, explaining each step clearly and using correct terminology throughout.

Key learning points

  • Known as the payment status report
  • Known as the payment return
  • Known as the customer payment status report
  • Known as the payment cancellation request
  • Pair of messages

Key terms

Reconciliation: The process of comparing records from two sources, such as a bank statement and an internal ledger, to confirm they agree.

ISO 20022: An international standard for financial messaging that defines XML message formats for payments, securities and trade.

Exception: A payment that cannot be processed normally and needs manual handling, investigation or repair. Exceptions arise from missing data, failed screening, account errors or system faults.

ISO 20022 XML explorer showing ISO 20022 Messages and Reason Codes for Exceptions (pacs.002, pacs.004, camt.056, camt.029, pain.002 with real reason codes).

Insights and practice scenarios

Worked insights and practice scenarios for this lesson. Each one is a reusable PaymentForge case, so the same case may appear in more than one lesson.

Practise this lesson

Exercise

Handle the exception described in this lesson the way the lesson prescribes.

Use the exception type, the reason code and the recovery path in this lesson.

  1. What to do. State what happened, what the correct action is, what must not be done, and what the post-incident review should capture.

Correct result. The correct action is the one the lesson prescribes for this exception type, with the right reason code and the right message. The payment must not be resent without checking whether it already settled, because that creates a duplicate.

Why. An exception handled wrongly is worse than the exception itself. A duplicate payment is a loss, and an unlearned exception will happen again.

Check your understanding

Practice question

Which of the following best describes ISO 20022 messages and reason codes for exceptions (pacs.002, pacs.004, camt.056, camt.029, pain.002 with real reason codes)?

Takeaway and next step

What to remember

Learning the twenty most common codes, and knowing which message carries each one, will make exception investigations faster, more accurate, and far less stressful for everyone involved.

Run the exception from this lesson and follow the investigation to its resolution.

Open the Exception Investigation Simulator →

Builds on "Unknown Payment Status, Failed Beneficiary Credit and Clearing System Outage".

Transcript and full text

Show transcript

The pacs.002 message, known as the payment status report, is the standard way for a bank to tell the sender whether a payment was accepted, rejected, or is still pending. It carries the original payment reference, the status, and, when the payment was rejected, a reason code that explains why. Common codes include AC01 for an incorrect account number, AC04 for a closed account, AM04 for insufficient funds, AM05 for a duplicate payment, and MD07 for an end customer who is deceased. An analyst who receives a pacs.002 with code AC01 knows immediately that the account number must be corrected by the customer, while a pacs.002 with code AM04 knows that the payment can be retried once funds are available. The pacs.004 message, known as the payment return, is sent when a payment that was already executed must be sent back to the sender. It carries the original payment reference, the returned amount, and a reason code, and it is the formal record that the money is on its way back. Typical return codes include AC04 for a closed account, AC06 for a blocked account, BE04 for a missing creditor address, and MD07 for an end customer who is deceased. The returned amount may be less than the original amount if fees were deducted in transit, for example a USD 10,000 payment returned as USD 9,975 after a USD 25 intermediary fee, and the reconciliation team must account for that difference explicitly. The pain.002 message, known as the customer payment status report, is the message a bank sends to its corporate customer to report the status of a payment the customer instructed. It is the customer-facing equivalent of the pacs.002, and it uses the same reason codes, so a corporate treasury system can process it automatically. For example, a company that submits a file of five hundred payments through a host-to-host connection will receive a pain.002 for each payment that fails, with codes such as AC01, AM05, or RR04 for a regulatory reason. The treasury team can then correct the failed payments and resubmit them without manual intervention, which is why large corporates insist on receiving pain.002 reports. The camt.056 message, known as the payment cancellation request, is used when the sending bank asks for a payment to be returned after it has already been executed, and it is the formal start of a recall. It carries the original payment reference, the reason for the recall, and the amount to be returned. The receiving bank replies with a camt.029 message, known as the resolution of investigation, which states whether the recall was accepted or rejected, and gives a reason code for the decision. Common camt.029 outcomes include a successful return, a rejection because the beneficiary does not agree, and a rejection because the funds are no longer available. The pair of messages creates a complete audit trail for the recall attempt. Analysts should treat reason codes as a language to learn, not as random letters to look up each time, because the same codes appear across messages and across banks. AC codes relate to account problems, AM codes relate to amount and duplicate problems, MD codes relate to the end customer, and RR codes relate to regulatory reasons. A payment rejected with code AC06, meaning a blocked account, needs a different conversation with the customer than a payment rejected with code AM04, meaning insufficient funds. Learning the twenty most common codes, and knowing which message carries each one, will make exception investigations faster, more accurate, and far less stressful for everyone involved.

The pacs.002 message, known as the payment status report, is the standard way for a bank to tell the sender whether a payment was accepted, rejected, or is still pending. It carries the original payment reference, the status, and, when the payment was rejected, a reason code that explains why. Common codes include AC01 for an incorrect account number, AC04 for a closed account, AM04 for insufficient funds, AM05 for a duplicate payment, and MD07 for an end customer who is deceased. An analyst who receives a pacs.002 with code AC01 knows immediately that the account number must be corrected by the customer, while a pacs.002 with code AM04 knows that the payment can be retried once funds are available.

The pacs.004 message, known as the payment return, is sent when a payment that was already executed must be sent back to the sender. It carries the original payment reference, the returned amount, and a reason code, and it is the formal record that the money is on its way back. Typical return codes include AC04 for a closed account, AC06 for a blocked account, BE04 for a missing creditor address, and MD07 for an end customer who is deceased. The returned amount may be less than the original amount if fees were deducted in transit, for example a USD 10,000 payment returned as USD 9,975 after a USD 25 intermediary fee, and the reconciliation team must account for that difference explicitly.

The pain.002 message, known as the customer payment status report, is the message a bank sends to its corporate customer to report the status of a payment the customer instructed. It is the customer-facing equivalent of the pacs.002, and it uses the same reason codes, so a corporate treasury system can process it automatically. For example, a company that submits a file of five hundred payments through a host-to-host connection will receive a pain.002 for each payment that fails, with codes such as AC01, AM05, or RR04 for a regulatory reason. The treasury team can then correct the failed payments and resubmit them without manual intervention, which is why large corporates insist on receiving pain.002 reports.

The camt.056 message, known as the payment cancellation request, is used when the sending bank asks for a payment to be returned after it has already been executed, and it is the formal start of a recall. It carries the original payment reference, the reason for the recall, and the amount to be returned. The receiving bank replies with a camt.029 message, known as the resolution of investigation, which states whether the recall was accepted or rejected, and gives a reason code for the decision. Common camt.029 outcomes include a successful return, a rejection because the beneficiary does not agree, and a rejection because the funds are no longer available. The pair of messages creates a complete audit trail for the recall attempt.

Analysts should treat reason codes as a language to learn, not as random letters to look up each time, because the same codes appear across messages and across banks. AC codes relate to account problems, AM codes relate to amount and duplicate problems, MD codes relate to the end customer, and RR codes relate to regulatory reasons. A payment rejected with code AC06, meaning a blocked account, needs a different conversation with the customer than a payment rejected with code AM04, meaning insufficient funds. Learning the twenty most common codes, and knowing which message carries each one, will make exception investigations faster, more accurate, and far less stressful for everyone involved.

Full lesson text (all scenes)

Completing a lesson updates your progress dashboard on the homepage.

Scene timestamps are estimated by allocating the narration text proportionally across the real audio length. The audio playback position is the source of truth: pause freezes the visual, seeking restores the correct scene, replay restarts the scene animation.