Selling cash on delivery
Abandoned checkouts
Shoppers who left their details at checkout without ordering. Read them, call them back, fix their address and turn them into orders.
What they are
When a shopper types their phone at checkout and leaves without ordering, the store keeps what they had chosen: the dashboard's Abandoned page. Many COD orders are won back by calling these people. The API exposes the same list, so a call-centre tool or a WhatsApp bot can work it.
An abandoned checkout has a status:
| Status | Means |
|---|---|
open | Still abandoned: someone should follow up. |
confirmed, recovered | The team turned it into an order (order_id). |
deleted | The team removed it, or it was closed after 30 days without activity. |
When the shopper finishes ordering themselves, the checkout is deleted, not kept as recovered: it was never really abandoned. This also happens when any new order arrives with the same phone number within 48 hours. Webhook endpoints get one last abandoned_checkout.updated with status: recovered and the order_id, then GET /v1/abandoned_checkouts/{id} answers 404.
A store keeps at most one open checkout per phone number: when the same number starts a new checkout, the existing one is updated (same id).
Hearing about them
Subscribe a webhook endpoint to abandoned_checkout.created. It fires when the shopper's contact is saved, which can be a few seconds before they finish ordering, so wait a little (a few minutes is typical) and read the checkout again: if it still exists and is open, it is truly abandoned. A 404 means the shopper finished the order. abandoned_checkout.updated follows when its status, contact, total or assignee changes.
Or poll GET /v1/abandoned_checkouts?status=open&updated_since=….
Working one
| You want to | Call |
|---|---|
| Fix the shopper's name, phone or address | PATCH /v1/abandoned_checkouts/{id} (same rules as an order) |
| Turn it into an order (the shopper said yes) | POST /v1/abandoned_checkouts/{id}/confirm: the answer is the new order, with the cart, delivery choice and marketing source |
| Give it to a teammate to call | POST /v1/abandoned_checkouts/assign (scope orders:assign) |
| Drop it | DELETE /v1/abandoned_checkouts/{id} |
Find a shopper's checkouts with ?phone=, in E.164 or the national form.
