FAQ

Short answers on sellability, keys vs keyless, idempotency, webhooks, and sandbox.

TopicsReference

Short answers to the questions partners ask most often while integrating the Seller API.

Sellability#

Why is a SKU in the catalog but not sellable?#

Four gates must all pass: commercial agreement (BMA), catalog share, allocation capacity, and territory pricing. Shared SKUs alone are not checkout-ready — merge snapshot with allocations and treat allocation sellable: true as authoritative. See Catalog and allocations and Sellable SKU readiness.

Why does preview say I cannot fulfill?#

canFulfill is false when inventory, territory, lifecycle, or price gates fail. Do not charge at your payment processor until preview succeeds.

Keys#

Do I always receive plaintext keys?#

Yes on a successful POST /orders response. GET /orders and webhooks never return key plaintext — see Fulfilment and keys.

Why are webhooks missing key plaintext?#

By design. Webhooks must not carry recoverable game keys. Store keys from the order response under your custody rules.

Idempotency#

What happens if I retry POST /orders?#

Reuse the same Idempotency-Key and body. You receive the original result. Changing the body under the same key returns IDEMPOTENCY_KEY_MISMATCH. See Idempotency.

Is orderReference the same as the idempotency key?#

No. orderReference is your stable store order id for reconciliation. Idempotency-Key is the HTTP replay token for that write. Use both.

Webhooks vs GET /orders#

Should I poll GET /orders for keys?#

No. GET /orders never returns key plaintext. Use the create-order response and signed order.fulfilled webhooks. If you lost the create-order response, POST /orders/recover-keys (scope seller:keys:pull) re-reads the keys already sold under that orderReference without pulling new inventory. Poll for status / reconciliation, not key reveal — see Polling and reconciliation.

What if a webhook is missed?#

Replay deliveries, then reconcile with order reads and your PSP settlement. Design handlers for at-least-once delivery.

Sandbox vs production#

Do I need a different host for sandbox?#

No. Same base URL; the API key selects sandbox vs production. Sandbox keys see the shared sandbox catalog and magic SKUs such as SANDBOX-ALWAYS-001. See Environments and Sandbox.

Can I test with a production key against magic SKUs?#

No. Magic SKUs belong to the shared sandbox catalog. Use a sandbox key.

Does Avrix refund my payment processor on 409?#

No. If you charged and Avrix returns NO_AVAILABLE_KEYS (or similar), refund at your PSP. Preview first so you rarely reach that path.

Security#

Can I call Seller API from the browser?#

No. Keys are server-to-server only. See Architecture patterns.

Next steps#

What links here

Published guides that link to this page.

Search docs

Search documentation…