What is the latest version of pain.002?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is pain.002.001.14.

What is the root element of pain.002?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:pain.002.001.14, and its message element is CstmrPmtStsRpt (CustomerPaymentStatusReport).

Is there an MT equivalent of pain.002?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

pain: Payments Initiation

pain.002 Customer Payment Status Report

Written and maintained by ZagTrader. Last reviewed 21 October 2026. How this page is sourced and checked

pain.002 is the ISO 20022 CustomerPaymentStatusReport message in the Payments Initiation business area (pain). The latest version is pain.002.001.14, and 13 versions are in the repository.

Message: CustomerPaymentStatusReport
Latest version: pain.002.001.14
Submitting organisation: ISTH/Swift
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What pain.002 is for

The CustomerPaymentStatusReport message is sent by an instructed agent to the previous party in the payment chain. It is used to inform this party about the positive or negative status of an instruction (either single or file). It is also used to report on a pending instruction.
The CustomerPaymentStatusReport message is exchanged between an agent and a non-financial institution customer to provide status information on instructions previously sent. Its usage will always be governed by a bilateral agreement between the agent and the non-financial institution customer.
The CustomerPaymentStatusReport message can be used to provide information about the status (for example a rejection, an acceptance) of the initiation of a credit transfer, a direct debit, as well as on the initiation of other customer instructions.
The CustomerPaymentStatusReport message refers to the original instruction(s) by means of references only or by means of references and a set of elements from the original instruction.
The CustomerPaymentStatusReport message can be used in domestic and cross-border scenarios.
The CustomerPaymentStatusReport may also be sent to the receiver of the payment in a real time payment scenario, as both sides of the transactions must be informed of the status of the transaction (that is either the beneficiary is credited, or the transaction is rejected).

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

pain.002 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

Version	Registration status	Published in
pain.002.001.14latest	Registered	Latest version set
pain.002.001.13	Registered	Previous version set
pain.002.001.12	Registered	Archive
pain.002.001.11	Registered	Archive
pain.002.001.10	Registered	Archive
pain.002.001.09	Registered	Archive
pain.002.001.08	Registered	Archive
pain.002.001.07	Registered	Archive
pain.002.001.06	Registered	Archive
pain.002.001.05	Registered	Archive
pain.002.001.04	Registered	Archive
pain.002.001.03	Registered	Archive
pain.002.001.02	Registered	Archive

pain.002 message structure

The building blocks of pain.002.001.14 to three levels, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

Document [1..1]
- CstmrPmtStsRpt CustomerPaymentStatusReport [1..1]
  - GrpHdr Group Header [1..1]GroupHeader128
    Set of characteristics shared by all individual transactions included in the status report message.
    - MsgId Message Identification [1..1]Max35Text
      Point to point reference, as assigned by the instructing party, and sent to the next party in the chain to unambiguously identify the message.
    - CreDtTm Creation Date Time [1..1]ISODateTime
      Date and time at which the message was created.
    - InitgPty Initiating Party [0..1]PartyIdentification272
      Party that initiates the status message.
      - Nm Name [0..1]Max140Text
      - PstlAdr Postal Address [0..1]PostalAddress27
      - Id Identification [0..1]Party52Choice (choice)
      - CtryOfRes Country Of Residence [0..1]CountryCode
      - CtctDtls Contact Details [0..1]Contact13
    - FwdgAgt Forwarding Agent [0..1]BranchAndFinancialInstitutionIdentification8
      Financial institution that receives the instruction from the initiating party and forwards it to the next agent in the payment chain.
      - FinInstnId Financial Institution Identification [1..1]FinancialInstitutionIdentification23
      - BrnchId Branch Identification [0..1]BranchData5
    - DbtrAgt Debtor Agent [0..1]BranchAndFinancialInstitutionIdentification8
      Financial institution servicing an account for the debtor.
      - FinInstnId Financial Institution Identification [1..1]FinancialInstitutionIdentification23
      - BrnchId Branch Identification [0..1]BranchData5
    - CdtrAgt Creditor Agent [0..1]BranchAndFinancialInstitutionIdentification8
      Financial institution servicing an account for the creditor.
      - FinInstnId Financial Institution Identification [1..1]FinancialInstitutionIdentification23
      - BrnchId Branch Identification [0..1]BranchData5
  - OrgnlGrpInfAndSts Original Group Information And Status [1..1]OriginalGroupHeader22
    Original group information concerning the group of transactions, to which the status report message refers to.
    - OrgnlMsgId Original Message Identification [1..1]Max35Text
      Point to point reference, as assigned by the original instructing party, to unambiguously identify the original message.
    - OrgnlMsgNmId Original Message Name Identification [1..1]Max35Text
      Specifies the original message name identifier to which the message refers.
    - OrgnlCreDtTm Original Creation Date Time [0..1]ISODateTime
      Date and time at which the original message was created.
    - OrgnlNbOfTxs Original Number Of Transactions [0..1]Max15NumericText
      Number of individual transactions contained in the original message.
    - OrgnlCtrlSum Original Control Sum [0..1]DecimalNumber
      Total of all individual amounts included in the original message, irrespective of currencies.
    - GrpSts Group Status [0..1]ExternalPaymentGroupStatus1Code
      Specifies the status of a group of transactions.
    - StsRsnInf Status Reason Information [0..*]StatusReasonInformation14
      Provides detailed information on the status reason.
      - Orgtr Originator [0..1]PartyIdentification272
      - Rsn Reason [0..1]StatusReason6Choice (choice)
      - AddtlInf Additional Information [0..*]Max105Text
    - NbOfTxsPerSts Number Of Transactions Per Status [0..*]NumberOfTransactionsPerStatus5
      Detailed information on the number of transactions for each identical transaction status.
      - DtldNbOfTxs Detailed Number Of Transactions [1..1]Max15NumericText
      - DtldSts Detailed Status [1..1]ExternalPaymentTransactionStatus1Code
      - DtldCtrlSum Detailed Control Sum [0..1]DecimalNumber
  - OrgnlPmtInfAndSts Original Payment Information And Status [0..*]OriginalPaymentInstruction51
    Information concerning the original payment information, to which the status report message refers.
    - OrgnlPmtInfId Original Payment Information Identification [1..1]Max35Text
      Unique identification, as assigned by the original sending party, to unambiguously identify the original payment information group.
    - OrgnlNbOfTxs Original Number Of Transactions [0..1]Max15NumericText
      Number of individual transactions contained in the original payment information group.
    - OrgnlCtrlSum Original Control Sum [0..1]DecimalNumber
      Total of all individual amounts included in the original payment information group, irrespective of currencies.
    - PmtInfSts Payment Information Status [0..1]ExternalPaymentGroupStatus1Code
      Specifies the status of the payment information group.
    - StsRsnInf Status Reason Information [0..*]StatusReasonInformation14
      Provides detailed information on the status reason.
      - Orgtr Originator [0..1]PartyIdentification272
      - Rsn Reason [0..1]StatusReason6Choice (choice)
      - AddtlInf Additional Information [0..*]Max105Text
    - NbOfTxsPerSts Number Of Transactions Per Status [0..*]NumberOfTransactionsPerStatus5
      Detailed information on the number of transactions for each identical transaction status.
      - DtldNbOfTxs Detailed Number Of Transactions [1..1]Max15NumericText
      - DtldSts Detailed Status [1..1]ExternalPaymentTransactionStatus1Code
      - DtldCtrlSum Detailed Control Sum [0..1]DecimalNumber
    - TxInfAndSts Transaction Information And Status [0..*]PaymentTransaction160
      Provides information on the original transactions to which the status report message refers.
      - StsId Status Identification [0..1]Max35Text
      - OrgnlInstrId Original Instruction Identification [0..1]Max35Text
      - OrgnlEndToEndId Original End To End Identification [0..1]Max35Text
      - OrgnlUETR Original UETR [0..1]UUIDv4Identifier
      - TxSts Transaction Status [0..1]ExternalPaymentTransactionStatus1Code
      - StsRsnInf Status Reason Information [0..*]StatusReasonInformation14
      - ChrgsInf Charges Information [0..*]Charges16
      - TrckrData Tracker Data [0..1]TrackerData7
      - AccptncDtTm Acceptance Date Time [0..1]ISODateTime
      - AcctSvcrRef Account Servicer Reference [0..1]Max35Text
      - ClrSysRef Clearing System Reference [0..1]Max35Text
      - OrgnlTxRef Original Transaction Reference [0..1]OriginalTransactionReference42
      - SplmtryData Supplementary Data [0..*]SupplementaryData1
  - SplmtryData Supplementary Data [0..*]SupplementaryData1
    Additional information that cannot be captured in the structured elements and/or any other specific block.
    - PlcAndNm Place And Name [0..1]Max350Text
      Unambiguous reference to the location where the supplementary data must be inserted in the message instance.
    - Envlp Envelope [1..1]SupplementaryDataEnvelope1
      Technical element wrapping the supplementary data.

Have a pain.002 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in pain.002

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

pain.002 questions

What is the latest version of pain.002?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is pain.002.001.14.
What is the root element of pain.002?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:pain.002.001.14, and its message element is CstmrPmtStsRpt (CustomerPaymentStatusReport).
Is there an MT equivalent of pain.002?: No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.