Skip to main content
The SODACARDS API lets you place orders for gift cards and game top-ups, read their status, fetch the delivered codes, and receive webhooks when an order is fulfilled — all from your own backend, priced at your reseller rates and settled from your prepaid wallet.

​
How it works

1

Authenticate

Every request carries an API key. Keys are scoped and can be locked to a set of IP addresses. See Authentication.
2

Place an order

POST /v1/orders with a product and quantity. The order settles from your wallet atomically and starts fulfilling.
3

Get the codes

When the order is fulfilled you receive an order.fulfilled webhook; fetch the codes from the authenticated codes endpoint.

​
Base URL

All requests go to a single base URL over HTTPS:

​
Live and sandbox

Your API key’s environment decides the mode. A sc_test_ key runs in the sandbox: orders are validated and priced exactly like live, but no wallet is charged and the codes returned are deterministic test values. A sc_live_ key runs against your real wallet and real supply.

​
Conventions

  • Money is in FCFA (XOF), a zero-decimal currency: an amount of 5000 means 5000 FCFA, not 50.00.
  • Timestamps are RFC 3339 (2026-07-25T09:52:00Z).
  • List endpoints are cursor-paginated. See Pagination.