CNP Refunds

This API call allows Merchants to process a refund for customers without having the physical card. This is know as the CNP Refund

👍

POST

{{url}}/retail/transaction/cnp-refund?group_id={{group-id}}

Headers

Name	Description
x-tu-authorization	protocol:TU1,accesskey:{{accessKey}},signedheaders:X-tu-date,signature:{{signature}}
X-tu-date	{{X-tu-date}}

Parameters:

Parameter	Description
group_id	{{group-id}}

Body:

curl --location -g '{{url}}/retail/transaction/cnp-refund?group_id={{group-id}}' \
--header 'x-tu-authorization: protocol:TU1,accesskey:{{accessKey}},signedheaders:X-tu-date,signature:{{signature}}' \
--header 'X-tu-date: {{X-tu-date}}' \
--data-raw '{"merchantNumber" : "{{merchantId}}",
"originalTransactionUuid" : "969f5887-caaf-4491-a363-b9ecc06d58af",
"transactionUuid" : "{{tx-uuid}}",
"description" : "Testing123",
"cardNotPresentData": {
"receiptEmail": "[email protected]",
"currency" : "ZAR"
},
"amount" : 100,
"groupId" : "{{group-id}}"
}'

Sample Response

{
  "txType": "CREDIT_RETURNS_REFUND",
  "result": "00",
  "resultDescription": "Approved or completed successfully",
  "sanitizedResultDescription": "Approved.",
  "authIdResp": "",
  "amount": 1000,
  "ccDigits": "0042",
  "currencyCode": "710",
  "settlementDate": null,
  "ccPrefix": "541333",
  "transactionDate": "2026-03-06T06:06:15.803+00:00",
  "traceNo": null,
  "approved": true,
  "source": "Acquirer",
  "token": null,
  "cardScheme": "MASTERCARD",
  "referenceNumber": "606506100003"
}