Sandbox vs live
The key decides the mode. Same URLs, same shapes.
| Test key (sandbox) | Live key | |
|---|---|---|
| Partners | Never dispatched. A simulated “Test Partner”. | Real Partners in your zone. |
| Money | Never moves. Wallet shows a fixed test balance. | Wallet / credit / cash as your company allows. |
| Prices | Simulated (distance based). | Real fare or your company rate card. |
| Status | Moves by itself in about 2 minutes, or step by step with POST /sandbox/orders/{id}/advance. | As the Partner works the order. |
| Webhooks | Sent to your test endpoints. | Sent to your live endpoints. |
| Order ids | ord_test_... | ord_live_... |
Test and live data never mix: a test key cannot see a live order and the other way round.
Sandbox timeline
searching→acceptedafter ~15 s (a Partner location and ETA appear)arrivedafter another ~30 sstartedafter another ~30 scompletedafter another ~45 s
Employees and cost centres are your real lists in both modes (they are only read).