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
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