On This Page
FILTER BY TAG

Refund a Payment

You can refund a completed payment for the full amount or a partial amount by sending a refund request. Twint supports multiple refund requests when the total amount of all of the refund requests is less than the captured amount.
Requesting a refund requires the request ID from the sale response. The request ID is located in the
id
 response field.

Endpoints

Production:
POST
https://api.cybersource.com
/pts/v2/payments/
{id}
/refunds
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments/
{id}
/refunds
The
{id}
 is the request ID contained in the original transaction request.

Response Statuses

Cybersource
 responds to your refund request with one of these statuses as the
status
 field value:
  • FAILED
    : The refund request failed.
  • REFUNDED
    : The refund request is accepted but is not completed. Request the check status service to retrieve status updates. For more information, see Check a Transaction Status.
When you send a check status request to retrieve an updated refund status, these are the possible responses:
  • FAILED
    : The refund request failed.
  • REFUNDED
    : The settled payment is successfully refunded.

Example: Refunding a Payment

Request
{
  "clientReferenceInformation": {
    "code": "refnum-1234"
  },
  "paymentInformation": {
    "paymentType": {
      "name": "eWallet",
      "method": {
        "name": "TWINT"
      }
    }
  },
  "processingInformation": {
    "actionList": "AP_REFUND"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "10.00",
      "currency": "CHF"
    }
  }
}
Response to a Successful Request
{
    "_links": {
        "self": {
            "method": "GET",
            "href": "/pts/v2/refunds/7546698758166740704805"
        },
        "status": {
            "method": "POST",
            "href": "/pts/v2/refresh-payment-status/7546698758166740704805"
        }
    },
    "clientReferenceInformation": {
        "code": "refnum-1234",
        "returnReconciliationId": "R04NNE1TJDUA"
    },
    "id": "7546698758166740704805",
    "orderInformation": {
        "amountDetails": {
            "currency": "CHF"
        }
    },
    "processorInformation": {
        "responseDetails": "00006",
        "transactionId": "519468592154",
        "responseCode": "00006"
    },
    "reconciliationId": "XFZ4084S9J0F",
    "refundAmountDetails": {
        "refundAmount": "10.00"
    },
    "status": "REFUNDED",
    "submitTimeUtc": "2025-08-08T16:17:57Z"
}
RELATED TO THIS PAGE