This page shows a pacs.002.001.10 compliant with SEPA Rulebook 2023.

Pacs.002.001.10 message

The JSON payload is for a pacs.002.001.10 ISO message with the fitoFIPmtStsRpt root element, and it contains the request details for submitting a payment.

The functional changes for SEPA Rulebook 2023 are highlighted.

Table: pacs.002.01.10.

Message field	Description	Data type	Required/Optional
grpHdr.msgId	Message ID, which must uniquely identify each request you send. This ID is used internally for idempotency of the API.	String	Required
grpHdr.creDtTm	Date and time of the payment request	String	Required
txInfAndSts.orgnlGrpInf.orgnlMsgId	Original Message Identification.	String	Required
txInfAndSts.orgnlGrpInf.orgnlMsgNmId	Original Message Name Identification. Value: pacs.008.001.08	String	Required
txInfAndSts.orgnlInstrId	Original Instruction Id.	String	Optional
txInfAndSts.orgnlEndToEndId	Original End To End Identification.	String	Required
txInfAndSts.orgnlTxId	Original Transaction Identification.	String	Optional
txInfAndSts.txSts	Specifies the status of a transaction, in a coded form.	String	Required
txInfAndSts.stsRsnInf.rsn	Specifies the reason for the status report. Can be cd or prtry	Object	Required
txInfAndSts.stsRsnInf.addtlInf	Aditional Informantion. First two elements will be provided only in rejected scenarios.	String	Optional
txInfAndSts.orgnlTxRef.intrBkSttlmAmt	Interbank Settlement Amount. The currency must be EUR and the amount must be a positive value.	Object	Required
txInfAndSts.orgnlTxRef.intrBkSttlmDt	Interbank Settlement Date.	String	Optional
txInfAndSts.orgnlTxRef.sttlmInf.sttlmMtd	Settlement Method.	String	Optional
txInfAndSts.orgnlTxRef.pmtTpInf.svcLvl.prtry	Payment scheme type.	String	Optional
txInfAndSts.orgnlTxRef.pmtTpInf.ctgyPurp	Category Purpose. Can be cd or prtry.	String	Optional
txInfAndSts.orgnlTxRef.pmtTpInf.purp	Purpose	String	Optional
txInfAndSts.orgnlTxRef.rmtInf	Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts receivable system. Can be strd or ustrd.	Object	Optional
txInfAndSts.orgnlTxRef.dbtr.pty.nm	Name by which a party is known and which is usually used to identify that party.	String	Optional
txInfAndSts.orgnlTxRef.dbtr.pty.pstlAdr.ctry	Code to identify a country, a dependency, or another area of particular geopolitical interest, on the basis of country names obtained from the United Nations (ISO 3166, Alpha-2 code).	String	Optional
txInfAndSts.orgnlTxRef.dbtr.pty.pstlAdr.adrLine		String	Optional
txInfAndSts.orgnlTxRef.dbtrAcct.id.iban		String	Optional
txInfAndSts.orgnlTxRef.dbtrAgt.finInstnId.bicfi		String	Optional
txInfAndSts.orgnlTxRef.cdtrAgt.finInstnId.bicfi		String	Optional
txInfAndSts.orgnlTxRef.cdtr.pty.nm	Name by which a party is known and which is usually used to identify that party.	String	Optional
txInfAndSts.orgnlTxRef.cdtr.pty.pstlAdr.ctry	Code to identify a country, a dependency, or another area of particular geopolitical interest, on the basis of country names obtained from the United Nations (ISO 3166, Alpha-2 code).	String	Optional
txInfAndSts.orgnlTxRef.cdtr.pty.pstlAdr.adrLine		String	Optional
txInfAndSts.orgnlTxRef.cdtrAcct.id.iban		String	Optional

Example request body:

{
    "fitoFIPmtStsRpt": {
        "grpHdr": {
            "msgId": "MsgId-2581783931",
            "creDtTm": "2021-02-03T04:05:06.000Z"
        },
        "txInfAndSts": [
            {
                "orgnlGrpInf": {
                    "orgnlMsgNmId": "pacs.008.001.08",
                    "orgnlMsgId": "MsgId-2581783930"
                },
                "orgnlEndToEndId": "E2eId-893748281",
                "orgnlTxId": "txId-1688023443",
                "txSts": "AC01",
                "stsRsnInf": [
                    {
                        "rsn": {
                            "cd": "AC01"
                        },
                        "addtlInf": [
                          "Incorrect Account Number"
                        ],

                    }
                ],
                "orgnlTxRef": {
                    "intrBkSttlmAmt": {
                      "ccy": "EUR",
                      "value": 100.00
                    },
                    "intrBkSttlmDt": "2021-02-03",
                    "dbtr": {
                        "pty": {
                            "nm": "Mr Debtor"
                        }
                    },
                    "dbtrAcct": {
                        "nm": "Mr Debtor",
                        "id": {
                            "iban": "ES9300492060833000002503"
                        }
                    },
                    "dbtrAgt": {
                        "finInstnId": {
                            "bicfi": "EBURESM1XXX"
                        }
                    },
                    "cdtr": {
                        "nm": "Mr Creditor"
                    },
                    "cdtrAcct": {
                        "id": {
                            "iban": "FI9580002811571214"
                        }
                    },
                    "cdtrAgt": {
                        "finInstnId": {
                            "bicfi": "BSCHESMMXXX"
                        }
                    }
                }
            }
        ]
    }
}

Request

The following example illustrates the request using raw HTTP code:

GET /payments/pacs002/v10/f792d3b2-723d-4602-a7a9-9102ac9ae2cf HTTP/1.1
Host: sandbox.api.pagonxt.com
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
X-Client-Id: YOUR_CLIENT_ID

The following example illustrates the response:


Content-Type: application/json
Content-Length: 478

{
    "fitoFIPmtStsRpt": {
        "grpHdr": {
            "msgId": "MsgId-2581783931",
            "creDtTm": "2021-02-03T04:05:06.000Z"
        },
        "txInfAndSts": [
            {
                "orgnlGrpInf": {
                    "orgnlMsgNmId": "pacs.008.001.08",
                    "orgnlMsgId": "MsgId-2581783930"
                },
                "orgnlEndToEndId": "E2eId-893748281",
                "orgnlTxId": "txId-1688023443",
                "txSts": "AC01",
                "stsRsnInf": [
                    {
                        "rsn": {
                            "cd": "AC01"
                        },
                        "addtlInf": [
                          "Incorrect Account Number"
                        ],

                    }
                ],
                "orgnlTxRef": {
                    "intrBkSttlmAmt": {
                      "ccy": "EUR",
                      "value": 100.00
                    },
                    "intrBkSttlmDt": "2021-02-03",
                    "dbtr": {
                        "pty": {
                            "nm": "Mr Debtor"
                        }
                    },
                    "dbtrAcct": {
                        "nm": "Mr Debtor",
                        "id": {
                            "iban": "ES9300492060833000002503"
                        }
                    },
                    "dbtrAgt": {
                        "finInstnId": {
                            "bicfi": "EBURESM1XXX"
                        }
                    },
                    "cdtr": {
                        "nm": "Mr Creditor"
                    },
                    "cdtrAcct": {
                        "id": {
                            "iban": "FI9580002811571214"
                        }
                    },
                    "cdtrAgt": {
                        "finInstnId": {
                            "bicfi": "BSCHESMMXXX"
                        }
                    }
                }
            }
        ]
    }
}

ISO20022 API Specification