pain.014.001.02
Scope This message is sent by a party to the next party in the creditor payment activation request chain. It is used to inform the latter about the positive or negative status of a creditor payment activation request (either single or file).
Message Construction
Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification
classDiagram
direction LR
%% CreditorPaymentActivationRequestStatusReportV02 recursion level 0 with max 0
CreditorPaymentActivationRequestStatusReportV02 *-- "1..1" GroupHeader46 : GroupHeader
CreditorPaymentActivationRequestStatusReportV02 *-- "1..1" OriginalGroupInformation25 : OriginalGroupInformationAndStatus
CreditorPaymentActivationRequestStatusReportV02 *-- "0..1" OriginalPaymentInstruction5 : OriginalPaymentInformationAndStatus
CreditorPaymentActivationRequestStatusReportV02 *-- "0..1" SupplementaryData1 : SupplementaryData
Now, we will zero-in one-by-one on each of these building blocks.
GroupHeader building block
Set of characteristics shared by all individual transactions included in the message. Set of characteristics shared by all individual transactions included in the message. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% GroupHeader46 recursion level 0 with max 1
class GroupHeader46{
MessageIdentification IsoMax35Text
CreationDateTime IsoISODateTime
}
GroupHeader46 *-- "1..1" PartyIdentification43 : InitiatingParty
GroupHeader46 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : DebtorAgent
GroupHeader46 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : CreditorAgent
%% PartyIdentification43 recursion level 1 with max 1
class PartyIdentification43{
Name IsoMax140Text
CountryOfResidence CountryCode
}
PartyIdentification43 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification43 *-- "0..1" IParty11Choice : Identification
PartyIdentification43 *-- "0..1" ContactDetails2 : ContactDetails
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
GroupHeader46 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| MessageIdentification | Point to point reference assigned by the instructing party and sent to the next party in the chain to unambiguously identify the message. | |
| CreationDateTime | Date and time at which the status report was created by the instructing party. | IsoISODateTime - Required 1..1 |
| InitiatingParty | Party initiating the creditor payment activation request. This can either be the creditor himself or the party that initiates the request on behalf of the creditor. | PartyIdentification43 - Required 1..1 |
| DebtorAgent | Financial institution servicing an account for the debtor. | BranchAndFinancialInstitutionIdentification5 - Optional 0..1 |
| CreditorAgent | Financial institution servicing an account for the creditor. | BranchAndFinancialInstitutionIdentification5 - Optional 0..1 |
OriginalGroupInformationAndStatus building block
Original group information concerning the group of transactions, to which the status report message refers to. Set of elements used to provide information on the original group, to which the message refers. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% OriginalGroupInformation25 recursion level 0 with max 1
class OriginalGroupInformation25{
OriginalMessageIdentification IsoMax35Text
OriginalMessageNameIdentification IsoMax35Text
OriginalCreationDateTime IsoISODateTime
OriginalNumberOfTransactions IsoMax15NumericText
OriginalControlSum IsoDecimalNumber
GroupStatus TransactionGroupStatus3Code
}
OriginalGroupInformation25 *-- "0..0" StatusReasonInformation9 : StatusReasonInformation
OriginalGroupInformation25 *-- "0..0" NumberOfTransactionsPerStatus3 : NumberOfTransactionsPerStatus
%% StatusReasonInformation9 recursion level 1 with max 1
class StatusReasonInformation9{
AdditionalInformation IsoMax105Text
}
StatusReasonInformation9 *-- "0..1" PartyIdentification43 : Originator
StatusReasonInformation9 *-- "0..1" IStatusReason6Choice : Reason
%% NumberOfTransactionsPerStatus3 recursion level 1 with max 1
class NumberOfTransactionsPerStatus3{
DetailedNumberOfTransactions IsoMax15NumericText
DetailedStatus TransactionIndividualStatus3Code
DetailedControlSum IsoDecimalNumber
}
OriginalGroupInformation25 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| OriginalMessageIdentification | Point to point reference, as assigned by the original instructing party, to unambiguously identify the original message. | IsoMax35Text - Required 1..1 |
| OriginalMessageNameIdentification | Specifies the original message name identifier to which the message refers. | IsoMax35Text - Required 1..1 |
| OriginalCreationDateTime | Date and time at which the original message was created. | IsoISODateTime - Optional 0..1 |
| OriginalNumberOfTransactions | Number of individual transactions contained in the original message. | IsoMax15NumericText - Optional 0..1 |
| OriginalControlSum | Total of all individual amounts included in the original message, irrespective of currencies. | IsoDecimalNumber - Optional 0..1 |
| GroupStatus | Specifies the status of a group of transactions. | TransactionGroupStatus3Code - Optional 0..1 |
| StatusReasonInformation | Set of elements used to provide detailed information on the status reason. | StatusReasonInformation9 - Unknown 0..0 |
| NumberOfTransactionsPerStatus | Detailed information on the number of transactions for each identical transaction status. | NumberOfTransactionsPerStatus3 - Unknown 0..0 |
OriginalPaymentInformationAndStatus building block
Information concerning the original payment information, to which the status report message refers. Provides details on the original transactions, to which the status report message refers. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% OriginalPaymentInstruction5 recursion level 0 with max 1
class OriginalPaymentInstruction5{
OriginalPaymentInformationIdentification IsoMax35Text
OriginalNumberOfTransactions IsoMax15NumericText
OriginalControlSum IsoDecimalNumber
PaymentInformationStatus TransactionGroupStatus3Code
}
OriginalPaymentInstruction5 *-- "0..0" StatusReasonInformation9 : StatusReasonInformation
OriginalPaymentInstruction5 *-- "0..0" NumberOfTransactionsPerStatus3 : NumberOfTransactionsPerStatus
OriginalPaymentInstruction5 *-- "0..0" PaymentTransaction41 : TransactionInformationAndStatus
%% StatusReasonInformation9 recursion level 1 with max 1
class StatusReasonInformation9{
AdditionalInformation IsoMax105Text
}
StatusReasonInformation9 *-- "0..1" PartyIdentification43 : Originator
StatusReasonInformation9 *-- "0..1" IStatusReason6Choice : Reason
%% NumberOfTransactionsPerStatus3 recursion level 1 with max 1
class NumberOfTransactionsPerStatus3{
DetailedNumberOfTransactions IsoMax15NumericText
DetailedStatus TransactionIndividualStatus3Code
DetailedControlSum IsoDecimalNumber
}
%% PaymentTransaction41 recursion level 1 with max 1
class PaymentTransaction41{
StatusIdentification IsoMax35Text
OriginalInstructionIdentification IsoMax35Text
OriginalEndToEndIdentification IsoMax35Text
TransactionStatus TransactionIndividualStatus3Code
AcceptanceDateTime IsoISODateTime
AccountServicerReference IsoMax35Text
ClearingSystemReference IsoMax35Text
}
PaymentTransaction41 *-- "0..0" StatusReasonInformation9 : StatusReasonInformation
PaymentTransaction41 *-- "0..0" Charges2 : ChargesInformation
PaymentTransaction41 *-- "0..1" OriginalTransactionReference17 : OriginalTransactionReference
OriginalPaymentInstruction5 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| OriginalPaymentInformationIdentification | Unique identification, as assigned by the original sending party, to unambiguously identify the original payment information group. | IsoMax35Text - Required 1..1 |
| OriginalNumberOfTransactions | Number of individual transactions contained in the original payment information group. | IsoMax15NumericText - Optional 0..1 |
| OriginalControlSum | Total of all individual amounts included in the original payment information group, irrespective of currencies. | IsoDecimalNumber - Optional 0..1 |
| PaymentInformationStatus | Specifies the status of the payment information group. | TransactionGroupStatus3Code - Optional 0..1 |
| StatusReasonInformation | Provides detailed information on the status reason. | StatusReasonInformation9 - Unknown 0..0 |
| NumberOfTransactionsPerStatus | Detailed information on the number of transactions for each identical transaction status. | NumberOfTransactionsPerStatus3 - Unknown 0..0 |
| TransactionInformationAndStatus | Provides information on the original transactions to which the status report message refers. | PaymentTransaction41 - Unknown 0..0 |
SupplementaryData building block
Additional information that cannot be captured in the structured elements and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
SupplementaryData1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PlaceAndName | Unambiguous reference to the location where the supplementary data must be inserted in the message instance. In the case of XML, this is expressed by a valid XPath. | IsoMax350Text - Optional 0..1 |
| Envelope | Technical element wrapping the supplementary data. | IsoSupplementaryDataEnvelope1 - Required 1..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the CreditorPaymentActivationRequestStatusReportV02 implementation follows a specific implementaiton pattern. First of all, CreditorPaymentActivationRequestStatusReportV02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CreditorPaymentActivationRequestStatusReportV02Document implements IOuterDocument. Because CreditorPaymentActivationRequestStatusReportV02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CreditorPaymentActivationRequestStatusReportV02.
classDiagram
class IOuterRecord
CreditorPaymentActivationRequestStatusReportV02 --|> IOuterRecord : Implements
CreditorPaymentActivationRequestStatusReportV02Document --|> IOuterDocument~CreditorPaymentActivationRequestStatusReportV02~ : Implements
class IOuterDocument~CreditorPaymentActivationRequestStatusReportV02~ {
CreditorPaymentActivationRequestStatusReportV02 Message
}
Document wrapper for serialization
The only real purpose CreditorPaymentActivationRequestStatusReportV02Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:pain.014.001.02’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using CreditorPaymentActivationRequestStatusReportV02.ToDocument() method. The returned CreditorPaymentActivationRequestStatusReportV02Document value will serialize correctly according to ISO 20022 standards.
classDiagram
CreditorPaymentActivationRequestStatusReportV02Document *-- CreditorPaymentActivationRequestStatusReportV02 : Document
Sample of message format
This is an abbreviated version of what the message should look like.
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.014.001.02">
<CdtrPmtActvtnReqStsRpt>
<GrpHdr>
<!-- GroupHeader inner content -->
</GrpHdr>
<OrgnlGrpInfAndSts>
<!-- OriginalGroupInformationAndStatus inner content -->
</OrgnlGrpInfAndSts>
<OrgnlPmtInfAndSts>
<!-- OriginalPaymentInformationAndStatus inner content -->
</OrgnlPmtInfAndSts>
<SplmtryData>
<!-- SupplementaryData inner content -->
</SplmtryData>
</CdtrPmtActvtnReqStsRpt>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_r_AYEFkyEeGeoaLUQk__nA_-2103829610"
nextVersions="_g6BqUSNqEeKdIYatzYH-pQ"
previousVersion="_GV_IptEvEd-BzquC8wXy7w_1012339931"
name="CreditorPaymentActivationRequestStatusReportV02"
definition="Scope
This message is sent by a party to the next party in the creditor payment activation request chain.
It is used to inform the latter about the positive or negative status of a creditor payment activation request (either single or file)."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlTag="CdtrPmtActvtnReqStsRpt"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_r_dEAVkyEeGeoaLUQk__nA_-1816396087"
name="GroupAndTransactionStatus1Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to ACTC, ACCP, ACSP or ACSC, ACCR or ACWC, then TransactionInformationAndStatus/TransactionStatus must be different from RJCT."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_r_mN8FkyEeGeoaLUQk__nA_1481498856"
name="GroupAndTransactionStatus2Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to PDNG, then TransactionInformationAndStatus/TransactionStatus must be different from RJCT."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_r_5I4FkyEeGeoaLUQk__nA_484426503"
name="GroupAndTransactionStatus3Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to RJCT, then TransactionInformationAndStatus/TransactionStatus must be different from ACTC, ACCP, ACSP, ACSC, ACCR, ACWC or PDNG."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_sAC54FkyEeGeoaLUQk__nA_-512645850"
name="GroupAndTransactionStatus4Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to RCVD, then TransactionInformationAndStatus/TransactionStatus is not allowed."
registrationStatus="Provisionally Registered" />
<messageBuildingBlock
xmi:id="_r_JiAFkyEeGeoaLUQk__nA_1174820972"
name="GroupHeader"
definition="Set of characteristics shared by all individual transactions included in the message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="GrpHdr"
complexType="_UQlCcdp-Ed-ak6NoX_4Aeg_-1988631022" />
<messageBuildingBlock
xmi:id="_r_TTAFkyEeGeoaLUQk__nA_177748619"
name="OriginalGroupInformationAndStatus"
definition="Original group information concerning the group of transactions, to which the status report message refers to."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="OrgnlGrpInfAndSts"
complexType="_Pe9Ge9p-Ed-ak6NoX_4Aeg_-379878312" />
<messageBuildingBlock
xmi:id="_r_TTAVkyEeGeoaLUQk__nA_-819323734"
name="OriginalPaymentInformationAndStatus"
definition="Information concerning the original payment information, to which the status report message refers."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="OrgnlPmtInfAndSts"
complexType="_shbIo1kyEeGeoaLUQk__nA_518630129" />
<messageBuildingBlock
xmi:id="_r_dEAFkyEeGeoaLUQk__nA_1886276423"
name="SupplementaryData"
definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="SplmtryData"
complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
<messageDefinitionIdentifier
businessArea="pain"
messageFunctionality="014"
flavour="001"
version="02" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.