Skip to main content

Initiating a Link and Settle

Submit a Link and Settle instruction to atomically link and settle a payment across two RTGS.global participants.

← All recipes
Sign the request
curl -X POST "https://signing.api.example.com/v1/sign" \
  -H "Content-Type: application/json" \
  -d '{"SignFor":"RTGS:G:BL12345678","Method":"POST","PathAndQuery":"/v1/linkandsettle/link","Message":"{\"GrpHdr\":{\"MsgId\":\"a9bcdf070ab5472fb9529c84e2224a54\"},\"CdtTrfTxInf\":{\"PmtId\":{\"UETR\":\"d1fca09c-e91e-40ef-9bd6-74c10c21e725\",\"EndToEndId\":\"e2e-ref-001\"},\"DbitAmt\":{\"Ccy\":\"GBP\",\"Value\":\"1000.00\"},\"CrdtAmt\":{\"Ccy\":\"USD\",\"Value\":\"1270.00\"}},\"LinkIdentifiers\":[\"5C3D8999FE8344BD8777009C8BC9CA3B\"]}"}'
Submit the Link and Settle instruction
curl -X POST "https://api.example.com/v1/linkandsettle/link" \
  -H "Content-Type: application/json" \
  -H "rtgs-global-sig: {signature}" \
  -d '{"GrpHdr":{"MsgId":"a9bcdf070ab5472fb9529c84e2224a54"},"CdtTrfTxInf":{"PmtId":{"UETR":"d1fca09c-e91e-40ef-9bd6-74c10c21e725","EndToEndId":"e2e-ref-001"},"DbitAmt":{"Ccy":"GBP","Value":"1000.00"},"CrdtAmt":{"Ccy":"USD","Value":"1270.00"}},"LinkIdentifiers":["5C3D8999FE8344BD8777009C8BC9CA3B"]}'
Webhooks
linkandsettle.settled
{
  "specversion": "1.0",
  "type": "linkandsettle.settled",
  "source": "rtgs.global",
  "id": "d1fca09c-e91e-40ef-9bd6-74c10c21e725",
  "verificationmaterial": "{signature}",
  "data_base64": "{base64-encoded-payload}"
}