Ordexs API v1 Get an API key

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:

StatusMeans
openStill abandoned: someone should follow up.
confirmed, recoveredThe team turned it into an order (order_id).
deletedThe 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 toCall
Fix the shopper's name, phone or addressPATCH /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 callPOST /v1/abandoned_checkouts/assign (scope orders:assign)
Drop itDELETE /v1/abandoned_checkouts/{id}

Find a shopper's checkouts with ?phone=, in E.164 or the national form.