Octopus Cards API
Programmatic access to 10,000+ digital products across 100+ countries. Authenticate, query the catalog, create orders, and track fulfillment — all via a single REST endpoint.
Platform
Why build on Octopus Cards?
Sub-second Fulfillment
Synchronous voucher delivery for single-quantity orders. Async processing with webhook callbacks for bulk requests.
Multi-Currency Pricing
50+ settlement currencies with automatic forex conversion. Charges endpoint returns exact cost before you commit.
JWT + IP Whitelist
Short-lived tokens with refresh flow. Optional IP whitelisting for production. All voucher codes encrypted at rest.
Authentication
One call to authenticate
POST your credentials, get a JWT. Attach it as a Bearer token to every subsequent request. Tokens are short-lived with a refresh endpoint for long-running sessions.
- ✓Short-lived JWT with refresh flow
- ✓Optional IP whitelisting for production
- ✓TOTP and WebAuthn support for admin access
- ✓All credentials encrypted in transit and at rest
curl -X POST {{host}}/auth/login \
-H "Content-Type: application/json" \
-d '{"username": "your_key", "password": "your_secret"}'
# Response
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"expires_in": 3600
}Orders
Create an order in one request
Pass a product ID, quantity, and your reference. We handle vendor routing, inventory allocation, and fulfillment. Get back voucher codes in the response — or subscribe to webhooks for async delivery.
- ✓Bulk orders up to 1,000 units per request
- ✓Idempotent with your reference key
- ✓Webhook notifications on status change
- ✓Auto wallet deduction with full ledger
curl -X POST {{host}}/api/v1/orders \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"product_id": "steam_wallet_50_usd",
"quantity": 1,
"reference": "ord_abc123"
}'Integration
Three steps to production
Get Credentials
Receive your API key and secret. Authenticate via POST and receive a short-lived JWT.
Query the Catalog
Fetch products by country, category, or brand. Get real-time pricing, denominations, and inventory.
Place Orders
Submit order requests with product ID and quantity. Receive voucher codes synchronously or via webhook.
Start building today
Full API reference, request/response examples, and integration guides — everything you need to go from zero to production.