Partner API

Buy gift cards and eSIMs with a prepaid Spend Credits balance. Same catalog and fulfillment as the SpendCrypto app — authenticated with an API key.

API reference API keys Fund Spend Credits

Prepaid checkout

  1. Create an account and an API key on /developers/keys.
  2. Fund Spend Credits from /my-credits.
  3. Search the catalog, quote a price, then create an order with cryptoSlug=SCC.
  4. Poll the order. When it is delivered, call reveal-codes for vouchers or eSIM install data.

Authentication

Send the key on every request. Either header works:

Authorization: Api-Key YOUR_KEY
X-Api-Key: YOUR_KEY
X-Client: agent

MCP

Agents connect to https://api.spendcrypto.com/mcp with the same API key. Cursor and Claude Code send it on every request. Claude.ai directory listing waits on OAuth (later).

{
  "mcpServers": {
    "spendcrypto": {
      "url": "https://api.spendcrypto.com/mcp",
      "headers": {
        "Authorization": "Api-Key YOUR_KEY"
      }
    }
  }
}

Flow: search → quote → confirm with the user → create_order (scc or crypto) → get_order → reveal_codes. Voucher codes are cash; never paste them into group chat or TTS.

Create an order

curl -X POST "$API/api/v1/order-cart/" \
  -H "Authorization: Api-Key YOUR_KEY" \
  -H "Idempotency-Key: order-1" \
  -H "Content-Type: application/json" \
  -d '{
    "cryptoSlug": "SCC",
    "orderItems": [{
      "giftcardSid": "PRODUCT_SID",
      "voucherCurrency": "USD",
      "voucherAmount": 25,
      "quantity": 1
    }]
  }'

Machine-readable OpenAPI: /developers/openapi.json · fallback explorer on the API host /api/v1/docs/