Skip to main content
A redemption spends a participant’s balance, either as a raw amount or against a catalog reward. It can capture immediately or authorize value into HELD for later fulfillment. A pending redemption moves through PENDING to COMPLETED, FAILED, or CANCELLED. A completed redemption can then move to PARTIALLY_REVERSED or FULLY_REVERSED. Reversals restore value to the participant and are capped at the remaining unreversed amount. Create and list redemptions under /v1/participants/{id}/redemptions. Get and resolve a specific redemption or manage reversals at /v1/redemptions/{id}.

Endpoints

  • Redeem a raw amount of an asset
  • Redeem a catalog item by reward_id
  • List and get redemptions for a participant
  • Complete, fail, or cancel a pending redemption
  • List reversals on a redemption
  • Reverse a redemption (full or partial by amount)
For asynchronous fulfillment, see the Redemption lifecycle guide.