Making a credit transfer via TARGET
The request must include a JSON payload object in the request body. The JSON payload is a pacs.008 v8 ISO message with the FIToFICstmrCdtTrf root element, and it contains the request details for submitting a payment.
In this scenario imagine an international company which has an account at Bank A, and wants to make a payment to another company, bank B. This payment will be made through the TARGET system using a pacs.008 message
The following table only provides information about some especially important fields.
Message field | Description | Data type | Required/ Optional |
|---|---|---|---|
grpHdr.msgId | Point to point reference, as assigned by the instructing party, and sent to the next party in the chain to unambiguously identify the message. Usage: The instructing party has to make sure that MessageIdentification is unique per instructed party for a pre-agreed period. | String | Required |
grpHdr.CreDtTm | Date and time at which the message was created. | Date | Required |
grpHdr.NbOfTxs | Number of individual transactions contained in the message. | String | Required |
Type of address expressed as a code. | String | Required | |
CdtTrfTxInfCdtTrfTxInf.pmtId | Set of elements used to reference a payment instruction. | String | Required |
CdtTrfTxInfCdtTrfTxInf.PmtTpInf | Set of elements used to further specify the type of transaction. | String | Optional |
CdtTrfTxInfCdtTrfTxInf.IntrBkSttlmDt | Date on which the amount of money ceases to be available to the agent that owes it and when the amount of money becomes available to the agent to which it is due. | Date | Required |
CdtTrfTxInfCdtTrfTxInf.InstdAmt | Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party. | Numeric | Optional |
CdtTrfTxInfCdtTrfTxInf.ChrgBr | Specifies which party/parties will bear the charges associated with the processing of the payment transaction. | String | Required |
CdtTrfTxInfCdtTrfTxInf.InstgAgt | Agent that instructs the next party in the chain to carry out the (set of) instruction(s). | String | Required |
CdtTrfTxInfCdtTrfTxInf.InstdAgt | Agent that is instructed by the previous party in the chain to carry out the (set of) instruction(s). | String | Required |
CdtTrfTxInfCdtTrfTxInf.Dbtr | Party that owes an amount of money to the (ultimate) creditor. | String | Required |
CdtTrfTxInfCdtTrfTxInf.DbtrAgt | Financial institution servicing an account for the debtor. | String | Required |
CdtTrfTxInfCdtTrfTxInf.CdtrAgt | Financial institution servicing an account for the creditor. | String | Required |
CdtTrfTxInfCdtTrfTxInf.Cdtr | Party to which an amount of money is due. | String | Required |
Example request body:
{
"hubMessage": {
"messageType": "pacs_008_v08",
"document": {
"fitoFICstmrCdtTrf": {
"cdtTrfTxInf": [
{
"dbtrAcct": {
"id": {
"iban": "ES1900308001600391984273"
},
"nm": "dbtr-acc-name"
},
"instdAgt": {
"finInstnId": {
"bicfi": "BSCHESMMXXX"
}
},
"cdtrAcct": {
"id": {
"iban": "ES1900308001600391984274"
},
"nm": "cdtr-acc-name"
},
"cdtrAgt": {
"finInstnId": {
"bicfi": "BSCHESMMXXX"
}
},
"pmtId": {
"clrSysRef": "16081285",
"uetr": "fe8dfae7-8ae9-4ea2-8a42-5ece8517a4bf",
"instrId": "e43b0aedb6333a8d94968b9ab683d410",
"endToEndId": "tiefighters-e2e-id-9577470618052"
},
"intrBkSttlmAmt": {
"ccy": "EUR",
"value": 0.01
},
"intrBkSttlmDt": "2025-07-23",
"instrForNxtAgt": [
{
"instrInf": "Instruction info"
}
],
"cdtr": {
"nm": "cdtr-name",
"pstlAdr": {
"adrLine": [
"Calle Preciados 1"
]
}
},
"dbtr": {
"nm": "dbtr-name",
"pstlAdr": {
"adrLine": [
"Calle Preciados 1"
]
}
},
"dbtrAgt": {
"finInstnId": {
"bicfi": "BSCHESMMXXX"
}
},
"chrgBr": "SHAR",
"instgAgt": {
"finInstnId": {
"bicfi": "BSCHESMMXXX"
}
},
"rmtInf": {
"ustrd": [
"IDMPTCY-SI"
]
},
"sttlmTmIndctn": {
"cdtDtTm": "2025-07-23T09:48:25.051Z"
}
}
],
"grpHdr": {
"nbOfTxs": "1",
"msgId": "16daa38f708e35b5ba4a40419414dfcf",
"sttlmInf": {
"clrSys": {
"cd": "TGT"
},
"sttlmMtd": "CLRG"
},
"creDtTm": "2025-07-23T09:48:25.185Z"
}
}
},
"client": {
"internalId": "2002",
"initiator": "target2-gateway"
},
"coreData": {
"messageScheme": "pacs.008.001.08",
"internalId": "2002",
"paymentService": "lvp_international",
"initiator": "target2-gateway",
"paymentInstrument": "target2",
"rootEntity": "null",
"flow": "reception",
"tenant": "null"
},
"flow": "reception"
},
"executionId": {
"paymentHubId": "d6dba906-fbe0-3c83-a1f3-1b517e850a29",
"executionNumber": 0
}
}