Developers

The refund transaction method is used for refunding a previously settled transaction.

Refunds can have the original Sale amount or lower but cannot exceed the original amount. Thus, the refund transaction method is not suitable for payouts and winnings.

If a partial (lower than original amount) refund has been performed, multiple requests can follow to reach up to the original amount of the Sale transaction. Please note that partial refund requires specific Nuvei account configuration.

Refunds are performed by providing the Sale transactionID along with the AuthCode related to it. The refund request currency needs to match the original Sale transaction currency.

Sample Workflow

Work with a full refund workflow using the Simple Sale Payment and Partial Refund scenario in the Nuvei postman collection. Import the JSON file in the link into Postman and follow additional instructions in Testing APIs with Postman.

REST API Endpoints:

Live:

https://secure.safecharge.com/ppp/api/v1/refundTransaction.do

Sandbox:

https://ppp-test.safecharge.com/ppp/api/v1/refundTransaction.do

Example Request

{
    "merchantId": "4960497427404081578",
    "merchantSiteId": "197846",
    "timeStamp": "20200307171207",
    "relatedTransactionId": "1110000000004320374",
    "amount": "135.00",
    "currency": "EUR",
    "authCode": "111138",
    "clientRequestId": "20200307171207",
    "clientUniqueId": "20200307171207",
    "urlDetails": {
     "notificationUrl": "http://notificationUrl.com"
    },
    "checksum": "02a7dc8445080b83eb80bb2fd612591b55adb96e40eec05e839279f50c148927"
}

Example Response

{
    "transactionId": "1110000000004320465",
    "externalTransactionId": "",
    "gwErrorCode": 0,
    "gwExtendedErrorCode": 0,
    "transactionStatus": "APPROVED",
    "authCode": "111176",
    "clientUniqueId": "20200307171207",
    "CVV2Reply": "",
    "AVSCode": "",
    "transactionType": "Credit",
    "customData": "",
    "acquirerId": "19",
    "bin": "400002",
    "last4Digits": "8694",
    "ccCardNumber": "4****8694",
    "ccExpMonth": "09",
    "ccExpYear": "21",
    "cardType": "Credit",
    "cardBrand": "VISA",
    "internalRequestId": 178718948,
    "status": "SUCCESS",
    "errCode": 0,
    "reason": "",
    "merchantId": "4960497427404081578",
    "merchantSiteId": "197846",
    "version": "1.0",
    "clientRequestId": "20200307171207"
}