Gift Card API - Issue, Redeem & Manage Gift Cards | 99minds

We're building the future of agentic promotions. Sign up for early access!

Sign up
REST API

Gift Card API - Built to Power Every Store You Run

One REST API, the entire gift card lifecycle. Issue, sell, redeem, reload, and reverse digital and physical gift cards across every store and channel, then trigger reward workflows, loyalty points, and store credit from the same system.

Read the Docs
GET /giftcards/balance
{
  "data": {
    "giftcard_number": "I2XNR6Y0",
    "active": true,
    "balance": "10.00",
    "currency_code": "USD",
    "delivery_mode": "DIGITAL",
    "expired": false
  },
  "status": "OK",
  "code": 200
}

Rate Limit

150 req/min

Trusted by teams at

Bestop
Cariloha
Club Monaco
Birdsnest
Flynn Ohara
Corner Bakery
Tootsies
Jaxen Gray
Lovable
Mud Australia
Dunning
La Senza
Mizuno
Natori
DIM Paris
Pinstripes
Greg Norman
Solo Brands
Solstice Sunglasses
ThirdLove
Bestop
Cariloha
Club Monaco
Birdsnest
Flynn Ohara
Corner Bakery
Tootsies
Jaxen Gray
Lovable
Mud Australia
Dunning
La Senza
Mizuno
Natori
DIM Paris
Pinstripes
Greg Norman
Solo Brands
Solstice Sunglasses
ThirdLove

What is a gift card API

Built to Handle the Entire Gift Card Lifecycle

A gift card API is the set of endpoints your app calls to create, sell, redeem, and track gift cards, so you never have to build a system to track balances, catch fraud, or store transaction history from scratch. As a gift card API provider, 99minds handles the full lifecycle for both digital and physical cards, and connects every transaction to the loyalty points and store credit already running on the same platform.

1

Issue & Sell

Create cards under a campaign, or sell digital or physical cards, single or bulk, complete with a custom greeting message and a scheduled delivery date.

2

Redeem & Reload

Apply a partial or full redemption, top up a balance, refund onto the card, or cash out what's left, all in one call.

3

Sync via Webhooks

Every transaction fires a signed webhook, retried up to 5 times over roughly 4.5 hours. Nothing gets missed.

4

Cash Out

Cash out the remaining balance on a card in one call, where required by law or your own policy.

5

Refund

Refund a purchase back onto the card or to the original payment method, without touching the rest of the balance.

6

Void

Void a transaction outright, reversing it as if it never happened.

Gift card software with rewards built in

Gift Cards That Reward Customers, Automatically

Most gift card APIs treat a gift card as a one-off payout. 99minds gift card software connects it to what happens before and after that purchase, so every purchase can trigger a reward on its own.

Rewards, Built In

  • A gift card purchase can automatically earn loyalty points
  • Redeemed loyalty points can convert straight into gift card balance
  • A partial refund reduces both balances by the same percentage, in one call

Multi-Store by Default

  • Every request is tagged with a store_ref (a location ID), so a card issued at one location redeems at any other
  • Per-store reporting on every issue, sell, redeem, and reload
  • Single-store mode works the same way, just pass one reference

Auth & Rate Limits, Published

  • Sign in with an access token (a Bearer token), using separate keys for your website and your server
  • 150 requests per minute per IP address, the same limit on every plan
  • Every response tells you how many requests you have left, so there are no surprises

Signed Webhooks, Every Time

  • Every transaction type fires an event, from issuance to redemption to refund
  • Digitally signed (HMAC-SHA256), so you know it actually came from 99minds
  • Retried up to 5 times, with a longer wait between each try, if your endpoint is briefly down

Real Code. Not a Contact Form.

Redeem a Gift Card in One Call

Pass a unique client_order_id on any request that changes a balance, to link it to your own order. A retried request never double-charges a balance.

Request

POST /api/v1/giftcards/redeem

{
  "giftcard": {
    "store_ref": "store_8412d0...",
    "giftcard_number": "2179386532019412",
    "redemption_amount": 2.45,
    "client_order_id": "ODXXXXX2"
  }
}

200 OK

{
  "data": {
    "transaction": {
      "giftcard_number": "2179386532019412",
      "balance": "97.55",
      "transaction_type": "REDEMPTION",
      "transaction_amount": "2.45"
    }
  },
  "status": "OK",
  "code": 200
}
View the full API reference

Customer Success Stories

Don’t just take our word for it. Hear it from our successful customers. All Customer Stories

  • Mud Australia

    38%

    Increase Average Spend Over Gift Card Value

    Multi-Currency

    AUS $ USD $ GBP £

    30%

    Increase in Sales due to rise in Gift card Redemption frequency

    Saved 400hrs

    Manual work

    Mud Australia store
  • Solstice

    $640K

    In Sales due to Promotional Gift Cards

    45 Days

    Summer Promotion

    28%

    Increase in AOV

    Gift Card

    As new promotion channel

    Solstice campaign
  • Natori

    25%

    Increase in
    Customer LTV

    Omnichannel

    Online and In-store

    40%

    Higher Spending on Redemption

    Gift Cards

    As new marketing channel

    Natori product
  • Bestop

    $1.5M

    In Sales due to Gift Card Promotion

    60 Days

    Social Media promotion with Heather Storm

    20%

    Increase in AOV

    15%

    Increase in Conversion Rate

    Bestop promotion
  • Calico

    25%

    Increase in
    Customer LTV

    30%

    Increase in ARR

    10%

    Increase in AOV

    Omnichannel Loyalty & Referral

    New Customer Acquisition & Retention channel

    Calico loyalty
  • Tassels

    15%

    Increase in
    Customer LTV

    20%

    Increase in ARR

    15%

    Increase in AOV

    Omnichannel Loyalty & Referral

    New Customer Acquisition & Retention channel

    Tassels loyalty

Frequently Asked Questions

Everything you need to know about the 99minds gift card API - from integration time to multi-store management and sandbox testing.

  • A gift card API is a set of HTTP endpoints that let your application issue, redeem, reload, and track gift cards programmatically. 99minds exposes a REST API so any platform - Shopify, WooCommerce, custom POS, or mobile app - can plug in without custom middleware.

  • Most developers complete a basic integration in under a day using our REST endpoints and SDKs. Full-featured rollouts with webhooks, multi-store sync, and loyalty rules typically take one to two weeks depending on your stack.

  • Yes. 99minds has native plugins for Shopify and WooCommerce that wrap the API, so you can activate gift cards from the app store without writing code. For headless or custom storefronts, you call the REST endpoints directly.

  • Yes. The 99minds API includes loyalty primitives - points, tiers, and cashback - that attach to the same gift card object. You can issue a gift card as a reward, top it up on qualifying purchases, and expire unused balances, all through the same endpoints.

  • Each request carries a store_ref parameter. The API routes balance checks, redemptions, and reloads to the correct store ledger automatically. A card issued in one store can be redeemed in another if your policy allows it - no manual reconciliation required.

  • Yes. 99minds provides a full sandbox environment at sandbox.99minds.io with test card numbers, mock webhooks, and rate limits that mirror production. You can simulate issuing, redeeming, and expiring cards without touching live balances.

  • The API is REST over HTTPS, so any language that can make HTTP requests works. We publish official client libraries for JavaScript/Node, Python, Ruby, PHP, Java, and Go. cURL examples are included in every endpoint's documentation.

Get on board

Elevate customer experience, enhance brand rapport, boost revenue

Get started with the best customer retention platform for e-commerce and retail. 99minds helps small businesses and omnichannel retailers run Shopify coupon campaigns, launch gift card programs, loyalty programs, store credit, and memberships that boost customer lifetime value. Sign up for free!

Sign Up Free