Sandbox
The sandbox world: its listings, its pretend payments, its simulated site, and how it answers complaints.
The sandbox is a world of its own, at the same address as live, for trying everything before it is real. A sandbox key works exactly like a live one: same endpoints, same rules, same answers, the same webhooks.
Kept apart
- A sandbox key sees only the sandbox's listings, quotes and orders; a live key never sees them. An order can't mix the two.
- Your sandbox has its own keys and webhook endpoints, made in the same dashboard. Its events say
"sandbox": true. - Nothing in the sandbox is real: no seller is paid, no site ships anything, no card is charged, and nobody at Kiuki is alerted about it.
What is in it
Invented producers, and one site, Sandbox Warehouse 1, that holds their stock and ships to Great Britain (market GB, prices in GBP). Its listings never change id, and their stock is topped up as you buy:
| Listing | Pack | Producer | Temperature | Unit price |
|---|---|---|---|---|
6b69756b-5ab0-4000-8000-000000000401 | Oat bars, case of 12 | Sandbox Oats | ambient | £19.80 |
6b69756b-5ab0-4000-8000-000000000402 | Strawberry jam 340 g, case of 6 | Sandbox Preserves | ambient | £26.40 |
6b69756b-5ab0-4000-8000-000000000403 | Mature cheddar 200 g, case of 10 | Sandbox Dairy | chilled | £33.00 |
Its fulfilment charges come from a real rate card, so quotes look like live ones: a basket with ambient and chilled packs makes two shipments.
Payments
Sandbox orders are paid with an in-memory pretend card, never a real one, even though the sandbox runs on the same servers as live. You don't save a card for the sandbox. Each shipment is authorised as soon as it is placed, taken at dispatch and dropped if it is cancelled, as live ones are.
What happens to an order
- Placed: each shipment
pending,awaiting_payment: true(order.placed). - Within seconds: paid (
order.paid) and released to Sandbox Warehouse 1 (shipment.released). - Then, a minute or so apart:
acknowledged,picking,packed,dispatchedwith carrier "Sandbox Parcels" and a tracking number starting SBX,delivered. - Once every shipment has been dispatched, the order is
completed(order.completed); the deliveries follow.
You can cancel while a shipment is pending or acknowledged, as live.
Complaints
Once a sandbox shipment is dispatched, report a problem with one of its lines as live (POST /v1/complaints, scope complaint:write) and read it back. It is recorded and answered as a live one, with two differences. It never takes the sandbox's listings off sale, as every sandbox key buys them, so listing_paused stays false. And nobody at Kiuki reads it: instead, about 3 minutes after you report it, the sandbox resolves it as not upheld (status resolved, outcome not_upheld, with resolved_at and a resolution saying the sandbox resolved it), so you can try how your system shows a complaint Kiuki has decided. Until then it is open. Once it is resolved, you can report the same kind of problem with the same line again.