- 17 Sep 2024
- 8 Minutes to read
- Print
- DarkLight
Pacs.002.001.10
- Updated on 17 Sep 2024
- 8 Minutes to read
- Print
- DarkLight
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
sca-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ikh1YnRlc3RfcHJvX3NhbmRib3gifQ.eyJoZCI6ImMrMkRKZEUyeklSTkNTS3hMVEU1TnIzVGpmQzRaVUFreTlxM0FuNFZLc3M9Iiwibm9uY2UiOiI2ZGNmOTgyZmM4ZTQ0YmVlOTRiYiIsImFsZyI6IlNIQTI1NiIsImlhdCI6MTY1NDUyNjUyMSwibmJmIjoxNjU0NTI2NTIxLCJleHAiOjE2ODYwNjI1MjEsImp0aSI6IjcwNDJjMjNhLWMzYmItNGU2MS04NjI4LTA1ZDRjODg2MWM0ZSJ9.KqRmUansjP5c-TRg8HcCS65x8I7w6EjT8xDQS83MoYMJiITAX50p1-gtnhtNAD-1l2CdUJfbyV9TzOn7qzm0uXx0rdWOaJ79efV5gEamc3jQNNFfhok9kwwKnlOX5d60UwGfLYbAJdZBZc49eyYRIojacTSVAewcKdXpTbwPPJE140WEYLwWkSXmUCPg1dPNyrogduHGl8DYEPdiaPytty-Bp9H_wApvQ5VAYmu111WzMCI0SPmo-eLGAj20C1sRVgKpl_-Puo-9gT2XOK1EBoD6qG_a2PaPuFxkAcm3W0-NtbEiYFnkvcS8zbMpHjdKq84qmh7Fq9ZsrsKgVJMfug
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"
}
}
}
}
]
}
}