Reward State Management

Reward state management APIs control the lifecycle of an issued reward transaction. An issued reward can be redeemed, reverse-redeemed, or revoked:

  • Redeeming moves the reward from ISSUED to REDEEMED.
  • Reverse-redeeming moves the reward from REDEEMED back to ISSUED.
  • Revoking cancels the reward and refunds the points consumed during issuance.

Each state transition is gated by a brand-level configuration flag and is disabled by default.

APIDescription
Redeem User RewardRedeems an issued reward transaction (ISSUED to REDEEMED).
Reverse-Redeem User RewardReverses a redemption (REDEEMED to ISSUED).
Revoke User RewardRevokes an issued reward transaction (ISSUED to CANCELLED) and refunds the consumed points.