Skip to content
KiukiPlatform
Documentation

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:

ListingPackProducerTemperatureUnit price
6b69756b-5ab0-4000-8000-000000000401Oat bars, case of 12Sandbox Oatsambient£19.80
6b69756b-5ab0-4000-8000-000000000402Strawberry jam 340 g, case of 6Sandbox Preservesambient£26.40
6b69756b-5ab0-4000-8000-000000000403Mature cheddar 200 g, case of 10Sandbox Dairychilled£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

  1. Placed: each shipment pending, awaiting_payment: true (order.placed).
  2. Within seconds: paid (order.paid) and released to Sandbox Warehouse 1 (shipment.released).
  3. Then, a minute or so apart: acknowledged, picking, packed, dispatched with carrier "Sandbox Parcels" and a tracking number starting SBX, delivered.
  4. 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.