Test Gift Card Purchasing

The staging environment is preloaded with merchants chosen to exercise every offer shape your integration may encounter — fixed- and variable-value gift cards, boosted rates, vouchers, card-linked offers (CLOs), out-of-stock states, and group-exclusive rates. Use them to confirm your catalog, offer, and purchase flows handle each case correctly.

Staging onlyThese merchants and their offer configurations exist only in the staging environment. Catalogs and offers in production differ — always pull the live catalog before testing there. See Get Merchant Catalog.

How to use these merchants

Resolve the merchant and its offers from the catalog

Use Get Merchant Catalog, Get Gift Card Offers, or Get Virtual Card Offers.

Pick the merchant that matches the case you want to test

The tables below map each offer shape to a staging merchant.

Run your purchase or card-creation flow

See Purchase Gift Cards or Create Virtual Card. To test out-of-stock handling, see Get Inventory On Stocked Offers.

Legend — ✅ verified against the staging API on 2026-08-06 · ⏳ no merchant in staging currently demonstrates this case; the row is kept so the gap is visible, but there is nothing to test against yet.

Merchants change. Every ✅ row below was confirmed by querying getMerchants directly, but staging catalog data is rebuilt periodically — an earlier version of this page listed 24 merchants, of which 15 no longer existed. If a merchant here returns an empty array, list the current catalog rather than assuming your call is wrong:

curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"query":"query { getMerchants(offerTypes: { giftCardOffer: true, cardLinkedOffer: true }) { name slug } }"}'

Gift card offers

Test case	Merchant	Slug	Staging
Fixed value	Amazon	`amazon`	✅
Fixed value, with boosted rate	TacoTime	`tacotime`	✅
Fixed value, with voucher	Burger King	`burger-king`	✅
Fixed value, with boosted rate and voucher	Chuck E. Cheese’s	`chuck-e-cheeses`	✅
Variable value	Shake Shack	`shake-shack`	✅
Variable value, with boosted rate	Lowe’s	`lowes`	✅
Variable value, whole dollars only	Sephora	`sephora`	✅
Variable and fixed value	Belk	`belk`	✅
Variable value, with voucher	—	—	⏳
Variable and fixed value, different rates per fixed denomination	—	—	⏳
Variable and fixed value, different rates per denomination, with voucher	—	—	⏳
Redeemable with balance only	—	—	⏳
Redeemable at more than one store	—	—	⏳
Delivered as a QR code	—	—	⏳

Delivery formats currently in staging are CODES, URL, PIN_WITH_URL, and PIN_AS_CODE. No merchant is configured with a QR-code delivery format, so that case cannot be exercised here today.

Card-linked and virtual card offers

These merchants carry a card-linked offer (CLO), a gift card offer, or both. Use them to test offer precedence, 0% offers, multi-program CLOs, spend-capped offers, and out-of-stock fallback.

Card-linked offers are hidden by default. getMerchants returns only gift card offers unless you ask for CLOs explicitly:

query {
  getMerchants(offerTypes: { giftCardOffer: true, cardLinkedOffer: true }) {
    name
    offers { type cloDetails { regularRate promoRate promoMaxCap } }
  }
}

Without offerTypes, every offer comes back as GIFT_CARD_OFFER and CLOs look as though they do not exist in staging. They do — 16 merchants carry them.

Test case	Merchant	Slug	Offer types	Staging
Gift card and CLO — promo rate with a spend cap	Amazon	`amazon`	Gift Card + CLO	✅
Gift card and CLO — CLO is 0%	Burger King	`burger-king`	Gift Card + CLO	✅
CLO only	eBay	`ebay`	CLO	✅
Gift card and CLO — multiple CLOs on one merchant	Adidas	`adidas`	Gift Card + CLO	✅
Gift card and CLO — gift card is the primary offer	—	—	—	⏳
Gift card and CLO — CLO primary (single card program)	—	—	—	⏳
Gift card and CLO — CLO primary, offer ends at lifetime spend cap	—	—	—	⏳
Gift card and CLO — CLO primary, offer ends at monthly spend cap	—	—	—	⏳
Gift card and CLO — different CLO per descriptor	—	—	—	⏳
Gift card and CLO — gift card is out of stock	—	—	—	⏳

Amazon is the richest CLO fixture: regularRate 3%, promoRate 6%, promoMaxCap 1000. Burger King’s CLO has regularRate 0 with a 6% promo, which is the case to use for zero-base-rate handling.

Exclusive (group-based) rates

These merchants offer an exclusive rate that is only visible to accounts in a specific user group. Add your test account to the listed user group to see the rate.

User group	Merchant(s)	Tier	Staging
Silver_Business	Build-A-Bear Workshop, adidas	Silver	✅
Gold_Business	Build-A-Bear Workshop, adidas	Gold	✅
Platinum_Business	Build-A-Bear Workshop	Platinum	✅

Get started

Fluz Dashboard

Quickstarts

Test Gift Card Purchasing

How to use these merchants

Gift card offers

Card-linked and virtual card offers

Exclusive (group-based) rates

Next steps

Test addresses

Purchase a gift card

​How to use these merchants

​Gift card offers

​Card-linked and virtual card offers

​Exclusive (group-based) rates

​Next steps

Test addresses

Purchase a gift card

How to use these merchants

Gift card offers

Card-linked and virtual card offers

Exclusive (group-based) rates

Next steps