Use Case

Gift Cards and Stored Value

Create programmable gift cards that live inside wallets and redeem seamlessly at checkout.

Problem

Brands need stored value systems that support balance tracking, redemption rules, and fraud prevention.

Architecture
Gift Card Purchase
Orangepill Token Engine
Stored in Wallet
Redeemed at Checkout
Settlement

Implementation

  1. 1Create a gift card product and pricing.
  2. 2Mint a stored value token on purchase.
  3. 3Assign the token to a wallet balance.
  4. 4Redeem the balance during checkout.
Mint gift card
const giftCard = await orangepill.tokens.mint({
  type: "gift_card",
  amount: 100000,
  currency: "COP"
})

Production considerations

  • Enforce expiration and redemption rules in policy.
  • Log ledger entries for every balance movement.
  • Use idempotency for mint and redemption calls.
  • Support partial redemptions for higher flexibility.

Start building with Orangepill

Get access to programmable financial infrastructure and launch faster.