Go-live checklist
You don’t have to guess whether you’re production-ready, and you don’t have to ask us. One authenticated call returns every check, your score, and the exact next actions.
curl -sS https://api.ordercore.ai/v1/account/readiness -H "X-API-Key: $KEY"
The stage field moves through the sequence below. next is always
the shortest list of things standing between you and the following stage — work that list top-down.
The stages
Sandbox sandbox
You are on a self-serve sandbox tenant — the one you get from
/bootstrap/sandbox-key with no signup. It is disposable: it expires and its
data goes with it, and its key cannot be given write scope. Grading it against the
production ladder would only hand you steps you cannot take, so this stage says the useful
thing instead: go-live starts on a tenant of your own.
- Request your own key, then call this endpoint again
# evaluating? this stage is expected — nothing is wrong # ready to go live: ordercore.ai/bootstrap
Access access_missing
You have a key but no active API key record yet.
- Create at least one active API key
curl -sS https://api.ordercore.ai/v1/account/auth -H "X-API-Key: $KEY"
Write scope access_limited
Your key can read but not write — catalog, inventory and orders all need write scope.
- Use an API key with write scope
# check api_key_scopes in the auth response; ask support to reissue with write
Catalog catalog_missing
Nothing to sell yet. Seeding demo data is the fastest way through this stage.
- Create at least one product
- Create active SKUs linked to products
- Configure active price records
curl -sS -X POST https://api.ordercore.ai/v1/onboarding/demo-data -H "X-API-Key: $KEY" -H "Content-Type: application/json" -d '{}'Inventory inventory_missing
Products exist but nothing is in stock, so orders can’t reserve.
- Add stock to inventory balances
curl -sS -X POST https://api.ordercore.ai/v1/inventory/adjust -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
-d '{"sku_code":"RUNSHOE-43","location_code":"MAIN-WH","quantity_delta":10,"reason":"go-live seed"}'Operational operational
The basics work. What is left is the part that breaks in production rather than in a demo: webhooks, key TTL, and a real order.
- Register a checkout.completed webhook endpoint
- Confirm at least one successful delivery
- Resolve any abandoned deliveries from the last 24h
- Run the first order flow
- Rotate the key if it expires within 7 days
curl -sS -X POST https://api.ordercore.ai/v1/orders -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: first-order-001" -d '{"customer_id":"...","items":[{"sku_id":"...","quantity":1}]}'Go-live ready go_live_ready
Everything required is green. Shopify is the only optional item left.
- Optional: connect a Shopify store for app-channel orders
Production ready production_ready
Every check passes, including an active Shopify connection.
Why webhooks are a go-live check, not a nice-to-have
An agent completing checkout is only half the transaction — your systems have to learn about
it. Deliveries are signed and retried, and both a recent success and the absence of abandoned
deliveries are required for production_ready. Details:
webhooks.
Related
- Runnable examples — get to a first order fast in your stack
- API guide · markdown · OpenAPI 3.1
- Error handling · Rate limits