- 17 Sep 2024
- 5 Minutes to read
- Print
- DarkLight
Pacs.028.001.03
- Updated on 17 Sep 2024
- 5 Minutes to read
- Print
- DarkLight
This page shows a pacs.028.001.03 compliant with SEPA Rulebook 2023.
Pacs.028.001.03
The request must include a JSON payload object in the request body. The JSON payload is a pacs.028.001.03 ISO message with the fIToFIPmtStsReq root element, and it contains the request details for submitting a payment.
Table: pacs.028.001.03.
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 | Creation date-time. | String | Required |
grpHdr.instgAgt.finInstnId.bicfi | Instructing agent's BICFI. | String | Optional |
txInf.stsReqId | Unique identification, as assigned by an instructing party for an instructed party, to unambiguously identify the status request. | String | Optional |
orgnlGrpInf.orgnlMsgNmId | Original Message Name Identification. | String | Required |
orgnlGrpInf.orgnlMsgId | Original Message Identification. | String | Required |
txInf.orgnlTxId | Original Transaction Identification. | String | Required |
txInf.orgnlInstrId | Original Instruction Identification. | String | Optional |
txInf.orgnlEndToEndId | Original End To End Identification. | String | Required |
txInf.accptncDtTm | Acceptance date time. | String | Optional |
txInf.orgnlTxRef.pmtTpInf.svcLvl.cd | Payment scheme type. Value: SEPA | String | Optional |
txInf.orgnlTxRef.pmtTpInf.lclInstrm.cd | Local Instrument. | Object | Optional |
txInf.orgnlTxRef.dbtrAcct.id.iban | Debtor's IBAN | String | Required |
txInf.orgnlTxRef.dbtr.nm | Debtor's name | String | Optional |
txInf.orgnlTxRef.dbtrAgt.finInstnId.bicfi | Debtor's BICFI | String | Optional |
txInf.orgnlTxRef.cdtrAcct.id.iban | Creditor's IBAN | String | Required |
txInf.orgnlTxRef.cdtr.nm | Creditor's name | String | Optional |
txInf.orgnlTxRef.cdtrAgt.finInstnId.bicfi | Creditor's bicfi | String | Optional |
txInf.orgnlTxRef.rmtInf.ustrd | Unestructured remittance information. | String | Optional |
Example request body:
{
"fitoFIPmtStsReq": {
"grpHdr":
{
"msgId": "STI02800101202208161230140000001131",
"creDtTm": "2022-08-16T08:12:01.047Z",
"instgAgt": {
"finInstnId": {
"bicfi": "PAGOGB2LXXX"
}
}
}
,
"orgnlGrpInf": [
{
"orgnlMsgNmId": "pacs.008.001.08",
"orgnlMsgId": "STI008001020220220815162109208"
}
],
"txInf": [
{
"stsReqId": "stsReqId-220812093325395",
"orgnlInstrId": "CORE0220220815162109208",
"orgnlEndToEndId": "e2eId-220815162103767",
"orgnlTxId": "txtId-220815162103767",
"accptncDtTm": "2022-08-15T16:21:09.208Z",
"orgnlTxRef": {
"dbtrAcct": {
"id": {
"iban": "GB97PAGO72899000000270"
}
},
"cdtr": {
"nm": "Carlos"
},
"dbtr": {
"nm": "David"
},
"dbtrAgt": {
"finInstnId": {
"bicfi": "PAGOGB2LXXX"
}
},
"rmtInf": {
"ustrd": [
"no confirmation required"
]
},
"cdtrAcct": {
"id": {
"iban": "ES3600490001532111020111"
}
},
"cdtrAgt": {
"finInstnId": {
"bicfi": "BSCHESMMXXX"
}
},
"pmtTpInf": {
"svcLvl": {
"cd": "SEPA"
},
"lclInstrm": {
"cd": "INST"
}
}
}
}
]
}
}
Request
The following example illustrates the request using raw HTTP code:
POST /payments/pacs028/v03 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
Content-Length: 3283
{
"fitoFIPmtStsReq": {
"grpHdr":
{
"msgId": "STI02800101202208161230140000001131",
"creDtTm": "2022-08-16T08:12:01.047Z",
"instgAgt": {
"finInstnId": {
"bicfi": "PAGOGB2LXXX"
}
}
}
,
"orgnlGrpInf": [
{
"orgnlMsgNmId": "pacs.008.001.08",
"orgnlMsgId": "STI008001020220220815162109208"
}
],
"txInf": [
{
"stsReqId": "stsReqId-220812093325395",
"orgnlInstrId": "CORE0220220815162109208",
"orgnlEndToEndId": "e2eId-220815162103767",
"orgnlTxId": "txtId-220815162103767",
"accptncDtTm": "2022-08-15T16:21:09.208Z",
"orgnlTxRef": {
"dbtrAcct": {
"id": {
"iban": "GB97PAGO72899000000270"
}
},
"cdtr": {
"nm": "Carlos"
},
"dbtr": {
"nm": "David"
},
"dbtrAgt": {
"finInstnId": {
"bicfi": "PAGOGB2LXXX"
}
},
"rmtInf": {
"ustrd": [
"no confirmation required"
]
},
"cdtrAcct": {
"id": {
"iban": "ES3600490001532111020111"
}
},
"cdtrAgt": {
"finInstnId": {
"bicfi": "BSCHESMMXXX"
}
},
"pmtTpInf": {
"svcLvl": {
"cd": "SEPA"
},
"lclInstrm": {
"cd": "INST"
}
}
}
}
]
}
}