Frequently asked questions
The questions integrators ask most often, with short answers.
Is there a test environment?
Yes: sandbox is a separate environment running the same build as production; a test account is opened by application and approval, no business account needed. In production you can also create a test order without waiting for a real customer (how): it triggers your webhook, appears in the pull list and accepts status writes, but never enters revenue or commission and never reaches the kitchen or picking.
How do I rotate my credentials?
From the business's partner console: Integration details → Rotate. The old apiSecret is invalidated immediately; prepare your integration to pick up the new value before rotating.
What if I hit the rate limit?
You receive 429 with a Retry-After; wait that many seconds. The quota is 50 requests per 10 seconds per service group and key (see Authorization). Polling the menu with If-None-Match reduces your request count.
Should I integrate food or Çarşı?
Look at what the business sells. Menus and modifier groups (restaurants, cafés) → Food. Barcodes, stock and shelf picking (grocery, greengrocer, butcher, stationery) → Çarşı. One integrator can support both: the endpoints are shared and the key determines the business and the vertical (vertical in the GET /merchant response); endpoints that belong to a single vertical return 404 not_available_for_vertical with the other vertical's key.