- 17 Sep 2024
- 7 Minutes to read
- Print
- DarkLight
Camt.087.001.06
- Updated on 17 Sep 2024
- 7 Minutes to read
- Print
- DarkLight
This page shows a camt.087.001.06 compliant with SEPA Rulebook 2023.
Camt.087.001.06
The request must include a JSON payload object in the request body. The JSON payload is a camt.087.001.06 ISO message with the reqToModfyPmt root element, and it contains the request details for submitting a payment.
Table: camt.087.001.05.
Message field | Description | Data type | Required/Optional |
---|---|---|---|
assgnmt.id | Assignment ID, which must uniquely identify each request you send. This ID is used internally for idempotency of the API. | String | Required |
assgnmt.assgnr.agt.finInstnId.bicfi | Assigner's BICFI. | String | Required |
assgnmt.assgne.agt.finInstnId.bicfi | Assignee's BICFI. | String | Required |
assgnmt.creDtTm | Date and time of the payment request | String | Required |
case.id | Identifies the investigation case. | String | Required |
case.cretr.agt.finInstnId.bicfi | Case creator's BICFI. | String | Required |
undrlyg.intrBk.orgnlGrpInf.orgnlMsgId | Original Message Identification. | String | Required |
undrlyg.intrBk.orgnlGrpInf.orgnlMsgNmId | Original Message Name Identification. | String | Required |
undrlyg.intrBk.orgnlInstrId | Original Instruction Identification. | String | Optional |
undrlyg.intrBk.orgnlEndToEndId | Original End To End Identification. | String | Required |
undrlyg.intrBk.orgnlTxId | Original Transaction Identification. | String | Required |
undrlyg.intrBk.orgnlIntrBkSttlmDt | Original interbank settlement date. | String | Required |
undrlyg.intrBk.orgnlIntrBkSttlmAmt | Data structure containing the amount of money moved between the instructing agent and the instructed agent, as provided in the original instruction. The currency must be EUR and the amount must be a positive value. | Object | Required |
undrlyg.intrBk.orgnlTxRef.sttlmInf.clrSys.prtry | Clearing System. | String | Optional |
undrlyg.intrBk.orgnlTxRef.sttlmInf.sttlmMtd | Settlement method. | String | Optional |
undrlyg.intrBk.orgnlTxRef.pmtTpInf.svcLvl.prtry | Payment scheme type. Value: SEPA | String | Optional |
undrlyg.intrBk.orgnlTxRef.pmtTpInf.lclInstrm | Local Instrument. Can be cd or prtry. | Object | Optional |
undrlyg.intrBk.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 |
undrlyg.intrBk.orgnlTxRef.dbtrAcct.id.iban | Debtor's IBAN | String | Optional |
undrlyg.intrBk.orgnlTxRef.dbtr.nm | Debtor's name | String | Optional |
undrlyg.intrBk.orgnlTxRef.dbtrAgt.finInstnId.bicfi | Debtor's BICFI | String | Optional |
undrlyg.intrBk.orgnlTxRef.ultmtDbtr.pty.nm | Ultimate debtor's name | String | Optional |
undrlyg.intrBk.orgnlTxRef.ultmtDbtr.pty.id | Ultimate debtor's ID | String | Optional |
undrlyg.intrBk.orgnlTxRef.cdtrAcct.id.iban | Creditor's IBAN | String | Optional |
undrlyg.intrBk.orgnlTxRef.cdtr.pty.nm | Creditor's name | String | Optional |
undrlyg.intrBk.orgnlTxRef.cdtrAgt.finInstnId.bicfi | Creditor's bicfi | String | Optional |
undrlyg.intrBk.orgnlTxRef.ultmtCdtr.pty.nm | Ultimate creditor's name. | String | Optional |
undrlyg.intrBk.orgnlTxRef.ultmtCdtr.pty.id | Ultimate creditor's ID. | String | Optional |
undrlyg.intrBk.orgnlTxRef.purp | Purpose. Can be cd or prtry. | String | Optional |
mod.intrBkSttlmDt | Requested value for interbank settlement date. | String | Required |
instrForAssgne.cd | Coded information related to the processing of the investigation instruction, provided by the assigner, and intended for the assignee. | String | Optional |
instrForAssgne.instrInf | Further information complementing the coded instruction or instruction to the assignee. | String | Optional |
Example request body:
{
"reqToModfyPmt": {
"assgnmt": {
"id": "SCTI57941196788149666000",
"assgnr": {
"agt": {
"finInstnId": {
"bicfi": "PAGOES22XXX"
}
}
},
"assgne": {
"agt": {
"finInstnId": {
"bicfi": "IPAYESMMXXX"
}
}
},
"creDtTm": "2022-06-09T11:48:48.465Z"
},
"case": {
"id": "SCTI57941196788149666000",
"cretr": {
"agt": {
"finInstnId": {
"bicfi": "PAGOES22XXX"
}
}
}
},
"undrlyg": {
"intrBk": {
"orgnlGrpInf": {
"orgnlMsgId": "STI156316",
"orgnlMsgNmId": "pacs.008.001.08"
},
"orgnlEndToEndId": "e2eSTI156316",
"orgnlTxId": "txIdMBBV201807041659210169778",
"orgnlIntrBkSttlmAmt": {
"value": 6.66,
"ccy": "EUR"
},
"orgnlIntrBkSttlmDt": "2022-06-09",
"orgnlTxRef": {
"sttlmInf": {
"sttlmMtd": "CLRG",
"clrSys": {
"prtry": "TIP"
}
},
"pmtTpInf": {
"svcLvl": [
{
"cd": "SEPA"
}
],
"lclInstrm": {
"cd": "INST"
}
},
"dbtr": {
"pty": {
"nm": "Iberpay"
}
},
"dbtrAcct": {
"id": {
"iban": "ES2900490001552116244947"
}
},
"dbtrAgt": {
"finInstnId": {
"bicfi": "ESPBESMMC02"
}
},
"cdtrAgt": {
"finInstnId": {
"bicfi": "PAGOES22XXX"
}
},
"cdtr": {
"pty": {
"nm": "Iberpay"
}
},
"cdtrAcct": {
"id": {
"iban": "ES8699999999530000000024"
}
}
}
}
},
"mod": {
"IntrBkSttlmDt": "2023-03-01"
},
"instrForAssgne": {
"cd": "INQR",
"instrInf": "Instruction information"
}
}
}
Request
The following example illustrates the request using raw HTTP code:
POST /payments/camt087/v06 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
{
"reqToModfyPmt": {
"assgnmt": {
"id": "SCTI57941196788149666000",
"assgnr": {
"agt": {
"finInstnId": {
"bicfi": "PAGOES22XXX"
}
}
},
"assgne": {
"agt": {
"finInstnId": {
"bicfi": "IPAYESMMXXX"
}
}
},
"creDtTm": "2022-06-09T11:48:48.465Z"
},
"case": {
"id": "SCTI57941196788149666000",
"cretr": {
"agt": {
"finInstnId": {
"bicfi": "PAGOES22XXX"
}
}
}
},
"undrlyg": {
"intrBk": {
"orgnlGrpInf": {
"orgnlMsgId": "STI156316",
"orgnlMsgNmId": "pacs.008.001.08"
},
"orgnlEndToEndId": "e2eSTI156316",
"orgnlTxId": "txIdMBBV201807041659210169778",
"orgnlIntrBkSttlmAmt": {
"value": 6.66,
"ccy": "EUR"
},
"orgnlIntrBkSttlmDt": "2022-06-09",
"orgnlTxRef": {
"sttlmInf": {
"sttlmMtd": "CLRG",
"clrSys": {
"prtry": "TIP"
}
},
"pmtTpInf": {
"svcLvl": [
{
"cd": "SEPA"
}
],
"lclInstrm": {
"cd": "INST"
}
},
"dbtr": {
"pty": {
"nm": "Iberpay"
}
},
"dbtrAcct": {
"id": {
"iban": "ES2900490001552116244947"
}
},
"dbtrAgt": {
"finInstnId": {
"bicfi": "ESPBESMMC02"
}
},
"cdtrAgt": {
"finInstnId": {
"bicfi": "PAGOES22XXX"
}
},
"cdtr": {
"pty": {
"nm": "Iberpay"
}
},
"cdtrAcct": {
"id": {
"iban": "ES8699999999530000000024"
}
}
}
}
},
"mod": {
"IntrBkSttlmDt": "2023-03-01"
},
"instrForAssgne": {
"cd": "INQR",
"instrInf": "Instruction information"
}
}
}