Quickstart

Place your first order and fetch its codes in a few minutes.

This walks through placing an order with a sandbox key and fetching its codes.

1. Create a sandbox key

In your reseller dashboard, create an API key in the test environment. It is prefixed sc_test_ and shown once — copy it now.

2. Browse the catalog

Each product is a purchasable denomination. Its id is what you order.

cURL

curl https://api.sodacards.com/v1/catalog \
  -H "X-API-Key: sc_test_your_key_here"

import requests

resp = requests.get(
    "https://api.sodacards.com/v1/catalog",
    headers={"X-API-Key": "sc_test_your_key_here"},
)
print(resp.json())

const resp = await fetch("https://api.sodacards.com/v1/catalog", {
  headers: { "X-API-Key": "sc_test_your_key_here" },
});
console.log(await resp.json());

3. Place an order

Send the product id and quantity. Include an Idempotency-Key so a retry never places the order twice (see Idempotency).

cURL

curl https://api.sodacards.com/v1/orders \
  -H "X-API-Key: sc_test_your_key_here" \
  -H "Idempotency-Key: 7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "prod_123", "quantity": 1}'

import requests

resp = requests.post(
    "https://api.sodacards.com/v1/orders",
    headers={
        "X-API-Key": "sc_test_your_key_here",
        "Idempotency-Key": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    },
    json={"product_id": "prod_123", "quantity": 1},
)
print(resp.json())

The response carries the order id and its status.

4. Fetch the codes

Once the order is completed — you will receive an order.fulfilled webhook, or you can poll GET /v1/orders/{id} — fetch the codes:

curl https://api.sodacards.com/v1/orders/ord_123/codes \
  -H "X-API-Key: sc_test_your_key_here"

In the sandbox the codes are deterministic test values. Switch to a sc_live_ key to order against your real wallet and supply.