> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 only**
These 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](/get-catalog).
## How to use these merchants
Use [Get Merchant Catalog](/get-catalog), [Get Gift Card Offers](/get-gift-card-offers), or [Get Virtual Card Offers](/features/get-card-offers).
The tables below map each offer shape to a staging merchant.
See [Purchase Gift Cards](/purchase-gift-card) or [Create Virtual Card](/features/create-virtual-card). To test out-of-stock handling, see [Get Inventory On Stocked Offers](/get-inventory).
**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:
```bash theme={null}
curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
-H "Authorization: Bearer " \
-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:
```graphql theme={null}
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 | ✅ |
## Next steps
Known-good and known-bad addresses for exercising validation on cards and KYC.
Put a test merchant to work — run the purchase flow end to end.