This API reverses a redemption, moving every user reward in the transaction from the REDEEMED state back to ISSUED.

Use it to undo a redemption that was recorded in error, for example when a voucher was marked as redeemed by mistake or a return/exchange means the reward should become usable again. Only transactions in the REDEEMED state can be reverse-redeemed.

The endpoint is gated by the brand-level REVERSE_REDEEM_ENABLE configuration flag, which is false by default. Raise a ticket with Product support to enable this for your organisation.

Example request

curl --location --request POST 'https://eu.api.capillarytech.com/api_gateway/rewards/core/v1/user/reward/reverse-redeem?username={tillusername}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic <token>' \
  --data '{
    "txnId": 9876543210,
    "redemptionReversedEventDateTime": "2026-05-13T09:32:11.000Z",
    "redemptionReversedBy": "BRAND_OPERATOR",
    "redemptionReversalReason": "INCORRECT_REDEMPTION"
  }'

Prerequisites

• Authentication: Basic or OAuth authentication.
• The REVERSE_REDEEM_ENABLE brand configuration flag must be set to true for the org. It is false by default and is managed through the brand configuration API.
• The reward transaction must be in the REDEEMED state.

Request query parameters

Request body parameters

API Quick Reference

POST /api_gateway/rewards/core/v1/user/reward/reverse-redeem
   ├─ Request
   │   ├─ txnId (integer)
   │   ├─ redemptionReversedEventDateTime (string)
   │   ├─ redemptionReversedBy (string)
   │   └─ redemptionReversalReason (string)
   └─ Response
       ├─ status
       │   ├─ success (boolean)
       │   ├─ code (integer)
       │   └─ message (string)
       ├─ txnId (integer)
       ├─ state (string)
       └─ userRewardCount (integer)

Example response

{
  "status": {
    "success": true,
    "code": 200,
    "message": "Reward redemption reversed successfully"
  },
  "txnId": 9876543210,
  "state": "ISSUED",
  "userRewardCount": 1
}

Response parameters

Error codes