The purpose of this operation is to refund the amount of a previous payment, crediting the cardholder account and debiting the Merchant account.
A refund is performed against a previous payment, referencing its transactionID by sending a POST request over HTTPS to the /payments/{transactionID}/refund endpoint.
A refund can be performed:
- against purchase (PURS),
- against captured preauthorisation (AUTH -> Capture),
and it can be:
- a full refund when the total amount of the purchase is refunded to the cardholder,
- a partial refund when a subtotal of the total purchase is refunded to the cardholder.
Generate the transaction:
POST https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/refund
Header parameters
Request parameters
Here’s an example:
Request Header:
Autorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6I (...)
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/json
{
"merchant": {
"terminalId": 24,
"channel": "web",
"merchantTransactionId": "BO_Order Id: c9876bcasd"
},
"transaction": {
"transactionTimestamp": "2022-05-29T18:23:41.367Z",
"description": "This is a refund request",
"amount": {
"value": 10,
"currency": "PLN"
},
"originalTransaction": {
"id": "mvuy3dh3wucpsi4389fh",
"datetime": "2022-05-29T17:23:36.105Z"
}
}
}