Quickstart

Create a token, fetch products, and send your first reward order in four steps.

 

This Quickstart gets you from zero to a successful reward order using the standard flow:

  1. Create a token
  2. Fetch products
  3. Create an order
  4. Confirm fulfillment
Note: Use the stage environment first, then switch to production when your integration is ready.

Step 1: Create a token

Use your Email and AccessToken to create a Bearer token.

POST /v1/Tokens
curl -X POST "BASE_URL/v1/Tokens" \
  -H "Email: EMAIL" \
  -H "AccessToken: ACCESS_TOKEN"

Step 2: Fetch products

Retrieve available products and choose a valid ProductId.

GET /v1/Products
curl "BASE_URL/v1/Products?pageIndex=1&pageSize=25¤cyCode=USD" \
  -H "Authorization: Bearer TOKEN"
Tip: Cache product responses for performance.

Step 3: Create an order

Create a reward order using a selected product.

POST /v1/Orders
curl -X POST "BASE_URL/v1/Orders" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "Type": "DigitalDelivery",
    "LineItems": [{
      "ProductId": "PRODUCTA",
      "Value": 25,
      "Quantity": 1,
      "DigitalDeliveryAddress": {
        "Email": "recipient@example.com"
      }
    }],
    "PONumber": "PO-12345"
  }'

Step 4: Confirm fulfillment

Orders may complete instantly or return Pending.

GET /v1/Orders/{id}
curl "BASE_URL/v1/Orders/ORDER-ID" \
  -H "Authorization: Bearer TOKEN"
Warning: Reuse the same PONumber to avoid duplicate orders.

What’s next