# cheap-keys Supplier API

> cheap-keys (pay.mmokick.com) is a digital-goods storefront for game keys, virtual-currency
> top-ups and gift cards. Suppliers integrate through a public REST API: bearer-token auth
> (`ck_live_`/`ck_test_` prefixes), RFC 9457 problem+json errors, cursor pagination,
> idempotency keys, HMAC-SHA256-signed webhooks, and a deterministic sandbox. All prices
> are integer minor units, EUR base. Base URL: https://pay.mmokick.com/api/v1 — sandbox: https://sandbox-pay.mmokick.com/api/v1

Every documentation page is also available as raw markdown: append `.md` to its URL.

## Specifications
- [Supplier API (OpenAPI 3.1)](https://pay.mmokick.com/developers/openapi/supplier-api.yaml): the API suppliers call
- [Declared Stock contract (OpenAPI 3.1)](https://pay.mmokick.com/developers/openapi/declared-stock-supplier-contract.yaml): the API suppliers implement; we call it to reserve and provision keys
- [Top-up contract (OpenAPI 3.1)](https://pay.mmokick.com/developers/openapi/topup-contract.yaml): validate-then-execute delivery into player accounts
- [Postman collection](https://pay.mmokick.com/developers/postman/cheap-keys-supplier-api.postman_collection.json): generated from the Supplier API spec, base URLs preconfigured (sandbox default)

## Getting started
- [Authentication](https://pay.mmokick.com/developers/getting-started/authentication.md): bearer tokens, scopes, 401/403 semantics
- [Environments](https://pay.mmokick.com/developers/getting-started/environments.md): base URLs, sandbox fixtures and magic test values
- [First API call in 5 minutes](https://pay.mmokick.com/developers/getting-started/first-call.md)

## Guides
- [Your first sale in 15 minutes](https://pay.mmokick.com/developers/guides/first-sale-in-15-minutes.md): token, offer, key upload, sandbox test order, signed webhook
- [Declared stock](https://pay.mmokick.com/developers/guides/declared-stock.md): implement the reservation/provision contract; self-serve contract tester
- [Top-up products](https://pay.mmokick.com/developers/guides/topup-products.md): validate → execute delivery, form_fields
- [Webhooks](https://pay.mmokick.com/developers/guides/webhooks.md): HMAC-SHA256 signature verification in PHP/Node/Python with published test vectors

## Reference
- [Errors](https://pay.mmokick.com/developers/errors.md): every machine error code
- [Rate limits](https://pay.mmokick.com/developers/rate-limits.md): the actual numbers and headers
- [Fees](https://pay.mmokick.com/developers/fees.md): machine-readable fee schedule
- [Changelog](https://pay.mmokick.com/developers/changelog.md): dated API changes

## Optional
- [llms-full.txt](https://pay.mmokick.com/llms-full.txt): all documentation concatenated in one file