> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sodacards.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Sell gift cards and game top-ups from your own systems with the SODACARDS API.

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

<Steps>
  <Step title="Authenticate">
    Every request carries an API key. Keys are scoped and can be locked to a set of
    IP addresses. See [Authentication](/authentication).
  </Step>

  <Step title="Place an order">
    `POST /v1/orders` with a product and quantity. The order settles from your
    wallet atomically and starts fulfilling.
  </Step>

  <Step title="Get the codes">
    When the order is fulfilled you receive an `order.fulfilled`
    [webhook](/webhooks); fetch the codes from the authenticated codes endpoint.
  </Step>
</Steps>

## Base URL

All requests go to a single base URL over HTTPS:

```
https://api.sodacards.com/v1
```

## 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](/pagination).