Quickstart: Your First Gift Card Purchase

Now that you have a User Access Token, you can perform actions on behalf of the user. This quickstart runs the full happy path end to end — deposit funds, browse merchants, buy a gift card, and reveal it — all in the sandbox.

📘

Before you start

You'll need a User Access Token. Every request below must include it in the header:

Authorization: Bearer <YOUR_USER_ACCESS_TOKEN>

All calls go to the sandbox GraphQL endpoint: https://transactional-graph.staging.fluzapp.com/api/v1/graphql. No real money moves in sandbox — see Staging vs. Live Environment.

Step 1 — Deposit funds to your Fluz balance

Pre-loading your Fluz balance generally results in faster gift card purchases and can bypass certain velocity checks. You can deposit two ways:

• Manually via the sandbox Fluz website.
• Programmatically via the API using a saved payment method ID.

# Example: deposit to Fluz balance using a saved payment method ID
# → paste the verified mutation from the reference page

➡️ More detail: Deposit Funds · Retrieve Payment Method ID · Check Account Balance

Step 2 — Get available merchants

With your balance ready, fetch the catalog of available merchants and their cashback offers.

# Example: fetch the merchant catalog
# → paste the verified query from the reference page

➡️ More detail: Catalog Overview · Get Merchant Catalog

Step 3 — Purchase a gift card

You can purchase a gift card two ways:

• Option A — Merchant slug (recommended). Let Fluz automatically select the best available offer for that merchant.
• Option B — Specific offer ID. Manually choose an offer from the merchant catalog.

# Example A: purchase by merchant slug (best offer chosen automatically)
# Example B: purchase by specific offer ID
# → paste the verified mutations from the reference page

➡️ More detail: Purchase Gift Cards · Gift Card Error Codes

Step 4 — Reveal gift card details

Once purchased, retrieve the redeemable card details (number, PIN, and any redemption info).

# Example: reveal gift card details
# → paste the verified query from the reference page

➡️ More detail: View Gift Cards

What's next

You've completed a full transaction. From here you can explore:

• Virtual cards — issue and manage network-accepted virtual cards.
• Wallets & transfers — open spend accounts and move funds.
• Transaction activity — pull and annotate transaction history.
• Embedded widgets — drop Fluz flows into your own UI.

Want to learn more? Contact us at [email protected] to speak with our experts or request a demo.