Skip to content
Beta: the Biskèt Partner API may still change before v1 is final. Sandbox access is by request:partners@bisket.ai.

Pickup QR

When the restaurant prints the pickup ticket, it carries a QR code with a signed pickup token for that order, and a short manual code under it. The driver scans the QR (or types the code) in your app, and you call:

POST /v1/orders/{order_id}/pickup
{ "token": "<the scanned token>" } // or { "manual_code": "K7P2Q9" }

The order moves to picked_up (order.picked_up). The token is single-use and valid 8 hours.

Error Meaning
pickup_token_invalid Not a Biskèt token, or altered. Scan again.
pickup_token_wrong_order The ticket belongs to another order.
pickup_token_expired Older than 8 h: ask the restaurant to reprint.
pickup_token_used Already picked up.
pickup_manual_code_locked Too many wrong manual codes: scan the QR.

In the sandbox, POST /v1/sandbox/orders/{order_id}/simulations with {"action": "issue_pickup_token"} returns the token the ticket would carry (quickstart, step 7).