# SODACARDS

> The SODACARDS developer API: sell gift cards and game top-ups from your own systems.

## Docs

- [An order was fulfilled and its codes are ready to fetch](https://developer.sodacards.com/api-reference/an-order-was-fulfilled-and-its-codes-are-ready-to-fetch.md)
- [An order was refunded](https://developer.sodacards.com/api-reference/an-order-was-refunded.md)
- [DeleteWebhook](https://developer.sodacards.com/api-reference/publicapiservice/deletewebhook.md): DeleteWebhook removes a webhook endpoint.
- [GetOrder](https://developer.sodacards.com/api-reference/publicapiservice/getorder.md): GetOrder returns one of the reseller's orders by id, with its lines and  current status. A live key reads live orders and a test key reads its own  sandbox orders; an id that is not the caller's is reported as not found.
- [GetProduct](https://developer.sodacards.com/api-reference/publicapiservice/getproduct.md): GetProduct returns a single product by its id, priced for the reseller. The  id is the one carried by a catalog entry. A product the reseller may not see  (unlisted, hidden or inactive) is reported as not found, so an id cannot be  probed to learn what exists outside the reseller's catalog.
- [ListCatalog](https://developer.sodacards.com/api-reference/publicapiservice/listcatalog.md): ListCatalog returns a page of the products the reseller may sell, each with  the reseller's price. It is cursor-paginated: pass next_cursor from the  previous page to fetch the next. A product's id is the identifier used to  order it.
- [ListOrders](https://developer.sodacards.com/api-reference/publicapiservice/listorders.md): ListOrders returns a page of the reseller's orders, newest first. It is  cursor-paginated: pass next_cursor from the previous page to fetch the next.  A live key lists live orders and a test key lists its own sandbox orders.
- [ListWebhooks](https://developer.sodacards.com/api-reference/publicapiservice/listwebhooks.md): ListWebhooks returns the reseller's registered webhook endpoints. It never  returns their signing secrets.
- [Ping](https://developer.sodacards.com/api-reference/publicapiservice/ping.md): Ping confirms a key works and reports which reseller and environment it  authenticated as. It is the health check a developer hits first.
- [PlaceOrder](https://developer.sodacards.com/api-reference/publicapiservice/placeorder.md): PlaceOrder buys one or more products, settled from the reseller's prepaid  wallet. It is asynchronous: the order is accepted and fulfilled in the  background, so the response carries the order id and a status to poll. The  request MUST carry an Idempotency-Key header, so a retried request never  pla…
- [RegisterWebhook](https://developer.sodacards.com/api-reference/publicapiservice/registerwebhook.md): RegisterWebhook registers a URL to receive signed event deliveries. The URL  must be HTTPS and publicly routable. The response carries the signing secret  once; store it, as it is never shown again.
- [RevealOrderCodes](https://developer.sodacards.com/api-reference/publicapiservice/revealordercodes.md): RevealOrderCodes returns the delivered codes of a completed order. Codes are  available once the order is completed; a still-processing order reports that  it is not ready. Reveals are rate-limited per order.
- [Authentication](https://developer.sodacards.com/authentication.md): Authenticate every request with a scoped API key.
- [Errors](https://developer.sodacards.com/errors.md): How the API reports failures, and the machine codes you can branch on.
- [Idempotency](https://developer.sodacards.com/idempotency.md): Make order placement safe to retry.
- [Introduction](https://developer.sodacards.com/introduction.md): Sell gift cards and game top-ups from your own systems with the SODACARDS API.
- [Pagination](https://developer.sodacards.com/pagination.md): Page through list endpoints with opaque cursors.
- [Quickstart](https://developer.sodacards.com/quickstart.md): Place your first order and fetch its codes in a few minutes.
- [Rate limits](https://developer.sodacards.com/rate-limits.md): How request rate is bounded, and how to back off.
- [Webhooks](https://developer.sodacards.com/webhooks.md): Receive signed events when an order is fulfilled or refunded, and verify them.

## OpenAPI Specs

- [webhooks](https://developer.sodacards.com/api-reference/webhooks.yaml)
- [sodacards](https://developer.sodacards.com/api-reference/sodacards.yaml)