Response body
The following table shows the response body elements that are relevant for the current use case for the SEPA SCT Instant (SCT Inst) payment scheme. For details on all the response body elements for all supported payment schemes, see the Message field definition for pacs.008
Extract the value of the cdtTrfTxInf.pmtId.txId key to see the transaction IDs for the payment.
Table: Retrieve payment details – Relevant response body elements
Element | Description | Data type |
|---|---|---|
grpHdr.msgId | Message ID, which uniquely identifies each request that was sent. This ID is used internally for idempotency of the API. | String |
grpHdr.creDtTm | Date and time of the payment submission request | String |
grpHdr.nbOfTxs | Number of transactions within the message. Value: 1 | String |
grpHdr.ttlIntrBkSttlmAmt | Data structure containing the payment currency and the amount for the total interbank settlement. The currency is EUR and the amount is a positive value. If these fields are used, the amount is equal to the sum of all the transactions in the message. | Object |
grpHdr.sttlmInf.sttlmMtd | Settlement method. Value: CLRG | String |
grpHdr.sttlmInf.clrSys | Clearing System. Value: CAM | String |
cdtTrfTxInf.pmtId.endToEndId | End-to-end ID, which can be used to track the transaction between payment systems. If the ID is not available, the value is NOT PROVIDED. | String |
cdtTrfTxInf.pmtId.txId | Transaction ID, which uniquely identifies each transaction within the message | String |
Payment scheme type. Value: SEPA | String | |
SCT Instant (INST) processing code Value: INST | String | |
cdtTrfTxInf.pmtTpInf.ctgyPurp.prtry | Payment channel SCT Instant (INST) processing code Value: INST | String |
cdtTrfTxInf.intrBkSttlmAmt | Data structure containing the payment currency and the amount that was transferred. The currency is EUR and the amount is a positive value. | Object |
cdtTrfTxInf.chrgBr | Charge bearer type. The possible values are:
| String |
cdtTrfTxInf ► .intrmyAgt1 ► .intrmyAgt1Acct | Data structures containing the details for the intermediary agent and the agent's account. These structures are required if you use multiple agencies and agency accounts for debiting. | Object |
cdtTrfTxInf ► .dbtr ► .dbtrAcct ► .dbtrAgt | Data structures containing the details for the debtor, the debtor’s account, and the debtor agent | Object |
cdtTrfTxInf ► .cdtrAgt ► .cdtr ► .cdtrAcct | Data structures containing the details for the creditor agent, the creditor, and the creditor’s account | Object |
cdtTrfTxInf.rmtInf | Data structure containing remittance details | Object |
Example response body for the SEPA SCT Inst payment scheme:
{
"fitoFICstmrCdtTrf": {
"grpHdr": {
"msgId": "msgId-8fe000131",
"creDtTm": "2024-08-01T08:00:00.000+02:00",
"nbOfTxs": "1",
"ttlIntrBkSttlmAmt": {
"value": 6.47,
"ccy": "EUR"
},
"intrBkSttlmDt": "2024-08-01",
"sttlmInf": {
"sttlmMtd": "CLRG",
"clrSys": {
"prtry": "CAM"
}
},
"instgAgt": {
"finInstnId": {
"bicfi": "XXXXXXXX"
}
},
"instdAgt": {
"finInstnId": {
"bicfi": "XXXXXXXX"
}
}
},
"cdtTrfTxInf": [
{
"pmtId": {
"instrId": "pacs008-instrId",
"endToEndId": "pacs008-endToEndId",
"txId": "pacs008-txId"
},
"pmtTpInf": {
"svcLvl": [
{
"cd": "SEPA"
}
],
"ctgyPurp": {
"prtry": "INST"
},
"lclInstrm": {
"cd": "INST"
}
},
"intrBkSttlmAmt": {
"value": 6.47,
"ccy": "EUR"
},
"chrgBr": "SHAR",
"instgAgt": {
"finInstnId": {
"bicfi": "XXXXXXXX"
}
},
"dbtr": {
"nm": "DEBTOR NAME",
"pstlAdr": {
"adrTp": {
"cd": "ADDR"
},
"dept": "CL",
"strtNm": "NAME",
"bldgNm": "1",
"flr": "1",
"room": "D",
"pstCd": "28001",
"twnNm": "CITY",
"twnLctnNm": "CITY",
"ctrySubDvsn": "CITY",
"ctry": "ES",
"adrLine": [
"CL. NAME, 1 1 D",
"28001 CITY CITY"
]
},
"id": {
"prvtId": {
"dtAndPlcOfBirth": {
"birthDt": "1993-05-19",
"prvcOfBirth": "MADRID",
"cityOfBirth": "MADRID",
"ctryOfBirth": "ES"
}
}
}
},
"dbtrAcct": {
"id": {
"iban": "ES0700000000000000000000"
}
},
"dbtrAgt": {
"finInstnId": {
"bicfi": "XXXXXXXX"
}
},
"cdtrAgt": {
"finInstnId": {
"bicfi": "XXXXXXXX"
}
},
"cdtr": {
"nm": "CREDITOR NAME",
"pstlAdr": {
"adrTp": {
"cd": "ADDR"
},
"dept": "CL",
"strtNm": "NAME",
"bldgNm": "1",
"flr": "2",
"room": "I",
"pstCd": "28232",
"twnNm": "CITY",
"twnLctnNm": "CITY",
"ctrySubDvsn": "CITY",
"ctry": "ES",
"adrLine": [
"CL. NAME, 1 2 I",
"28232 CITY CITY"
]
}
},
"cdtrAcct": {
"id": {
"iban": "ES0700000000000000000001"
}
},
"ultmtCdtr":{
"nm": "ULTIMATE CREDITOR NAME",
"id": {
"orgId": {
"lei": "000000AAAA0AA00AAA00"
}
}
},
"rmtInf": {
"ustrd": [
"FAKE:ACCP:IT00"
],
"strd": [
{
"cdtrRefInf": {
"tp": {
"cdOrPrtry": {
"cd": "SCOR"
}
}
}
}
]
}
}
]
}
}