pacs.002.001.10 XSD schema and business logic

Learn how to generate valid pacs.002.001.10 messages for your ISO 20022 message-based integration to Mambu Payments (formerly Numeral)

Usage

pacs.002.001.10 are FIToFIPaymentStatusReport (PSR) messages. They provide statuses of one or multiple payments. Mambu Payments expects pacs.002.001.10 messages for payments in order to update their status and progress them through their lifecycle (see Payment order lifecycle and Return lifecycle).

A given payment can have one or multiple pacs.002.001.10 messages. In case of multiple pacs.002.001.10 messages, they must be ordered to respect the lifecycle of a payment. For instance, a payment order cannot be executed after it has been rejected.

The definitions and business rules below are applied by Mambu Payments. Your application should send pacs.002.001.10 complying with these definitions in business rules.

Definitions

Group level statuses

The Group Level Status is located under the Original Group Information and Status tag OrgnlGrpInfAndSts.GrpSts. Accepted values are the following:

Status codeStatus nameDefinition
RCVDReceivedThe related payment message has been received by the instructed agent. It has not yet been accepted or processed.
ACCPAcceptedThe related payment message has been accepted by the instructed agent.
RJCTRejectedAll payments in the group have been rejected by the instructed agent.
PARTPartially acceptedSome payments have been accepted and others have been rejected. Payments rejected are included at the transaction level.

Transaction level statuses

When applicable, individual payments are included in the Transaction Information and Status tag TxInfAndSts.TxSts. Accepted values are the following:

Status codeStatus nameDefinition
ACCPAcceptedThe payment has been processed by the instructed agent.
ACSPAccepted, settlement in progressThe payment has been processed by the instructed agent and is undergoing clearing and settlement.
ACSCAccepted, settlement completedThe payment has been processed, cleared, and settled by the instructed agent.
RJCTRejectedThe payment has been rejected by the instructed agent.
PDNGPendingThe payment has been put on hold and is waiting verification (e.g., compliance checks) and validation by the instructed agent.

Business rules

Identification of original payment

Priority level

Combination

1

OrgnlMsgId + OrgnlTxId
OrgnlMsgId + OrgnlUETR

2

OrgnlMsgId + OrgnlEndToEndId

3

OrgnlMsgId + OrgnlInstrId

4

OrgnlTxId
OrgnlUETR

5

OrgnlEndToEndId

6

OrgnlInstrId

7

OrgnlMsgId

Status priority processing

Business rule order

Description

1

If TxInfAndSts is present at least once, then the status of the individual payment referenced by TxInfAndSts is updated as follows :

  • RJCT: the individual payment is rejected
  • PDNG: the individual payment is pending
  • ACCP, ACSP or ACSC: the individual payment is executed

2

If TxInfAndSts is absent, then the status of the group of payments referenced by GrpInfAndSts are updated as follows:

  • RJCT: all payments in the group are rejected
  • RCVD: no change in the status
  • ACCP: either no change in the status or all payments in the group are executed (*)
  • PART: should not happen as transaction level detail is expected

3

If BR1 is verified, then the status of the group of payments referenced by GrpInfAndSts are updated as follows:

  • RJCT or ACCP: no impact as it has already been handled at transaction level
  • RCVD: not expected
  • PART: all remaining payments in the group that were not explicitly mentioned in BR1 are either unchanged or executed (*)

Implicit vs. explicit completion status