Get redemption update details

get

https://staging-onlinemerchants.suregifts.com/api/v2/redemptions/update/{reference}

Retrieves the complete details of a redemption update operation using your external reference.
This returns the same response structure as the POST /redemptions/update endpoint, showing all three transactions
created during the update operation.

Request

Method: GET
URL: /merchant-client/v2/redemptions/update/{reference}
Path Parameters:

reference (string, required) – Your unique external reference used during redemption

Responses

200 OK – Successful

Response Structure:

{
  "data": {
    "originalTransaction": {
      "transactionId": "12345",
      "transactionType": "REDEMPTION",
      "amount": 1000.00,
      "reference": "REF123456",
      "voucherCode": "ABC***",
      "serialNumber": "67890",
      "note": "Transaction canceled and replaced with new transaction. Original amount: 1,000.00, New amount: 500.00"
    },
    "cancellationTransaction": {
      "transactionId": "12346",
      "transactionType": "REDEMPTION_REVERSAL",
      "amount": -1000.00,
      "reference": "CANCEL-REF123456",
      "voucherCode": "ABC***",
      "serialNumber": "67890",
      "note": "Reversal of original transaction 12345"
    },
    "newTransaction": {
      "transactionId": "12347",
      "transactionType": "REDEMPTION",
      "amount": 500.00,
      "reference": "NEW-REF123456",
      "voucherCode": "ABC***",
      "serialNumber": "67890",
      "note": "Updated transaction created from original transaction 12345"
    },
    "summary": {
      "originalAmount": 1000.00,
      "newAmount": 500.00,
      "reference": "REF123456"
    }
  },
  "statusCode": "00",
  "message": "Success"
}

Field Descriptions:

Same as POST /redemptions/update endpoint. See above for complete field descriptions.

statusCode (string) – Status code ("00" indicates success).
message (string) – Human-readable message.

404 Not Found

Returned when no update operation is found with the given reference.

{
  "statusCode": "60",
  "message": "Not found."
}

Example cURL Request

curl -X GET \
  'https://{baseUrl}/merchant-client/v2/redemptions/update/REF123456' \
  -H 'Accept: application/json'

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Response

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK