Make your first API call

With an access token in hand, you’re ready to hit the API. Every call goes to a single GraphQL endpoint — the token decides whose account you’re operating on.

The endpoint

Staging: https://transactional-graph.staging.fluzapp.com/api/v1/graphql
Live: https://transactional-graph.fluzapp.com/api/v1/graphql

Query the viewer

viewer returns whichever account the token is scoped to. It’s a good smoke test that your token is valid.

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 { viewer { id email } }"
  }'

Expected response:

{
  "data": {
    "viewer": {
      "id": "usr_01H...",
      "email": "you@acme.com"
    }
  }
}

Purchase a gift card in staging

Once your token carries LIST_OFFERS and PURCHASE_GIFTCARD, you can list offers and purchase one end-to-end:

mutation PurchaseGiftCard($offerId: ID!, $amount: MoneyInput!) {
  purchaseGiftCard(offerId: $offerId, amount: $amount) {
    id
    status
    giftCard { code pin }
  }
}

Variables:

{
  "offerId": "offer_test_amazon_us",
  "amount": { "currency": "USD", "amount": 2500 }
}

Fluz uses request de-duplication on money-moving mutations. See Idempotency.

Where to next

Explore capabilities

Cards, wallets, gift cards, and payouts.

Build for customers

Connect customer accounts with OAuth.

⌘I

Get started

Fluz Dashboard

Quickstarts

Make your first API call

The endpoint

Query the viewer

Purchase a gift card in staging

Where to next

Explore capabilities

Build for customers

​The endpoint

​Query the viewer

​Purchase a gift card in staging

​Where to next

Explore capabilities

Build for customers

The endpoint

Query the viewer

Purchase a gift card in staging

Where to next