v1

latestOpenAPI 3.0.12026-07-24501176.6 MB

Reverse-Redeem User Reward

post/api_gateway/rewards/core/v1/user/reward/reverse-redeem

Query parameters

usernamestring

Store identifier used for gateway authentication.

Headers

Authorizationstring

X-CAP-API-OAUTH-TOKENstring

Request body

txnIdinteger required

Transaction ID of the issuance transaction to reverse-redeem.

redemptionReversedEventDateTimestring

Source event date-time in ISO 8601 format. Defaults to the processing time.

redemptionReversedBystring

Actor who initiated the reversal.

redemptionReversalReasonstring

Reason for reversing the redemption.

Example request

{
  "txnId": 9876543210,
  "redemptionReversedEventDateTime": "2026-05-13T09:32:11.000Z",
  "redemptionReversedBy": "BRAND_OPERATOR",
  "redemptionReversalReason": "INCORRECT_REDEMPTION"
}

Response

Outcome of the reverse-redeem. The result is conveyed in the status object.