Order statuses
Every order has exactly one status. There are three.
| Status | Meaning |
|---|---|
| Pending | The order is live. Work is outstanding. |
| Done | Every step is finished. Nothing more is expected. |
| Cancelled | The order was stopped and will not be completed. |
Pending
An order is Pending from the moment it is created until it is finished or cancelled. This is where an order spends nearly all of its life.
Pending says nothing about how far along the work is. An order waiting for a contractor to accept and an order waiting for a final photo are both Pending. For actual progress, look at the workflow steps on the order, not the status.
Done
An order becomes Done when the last step in its workflow is finished. It means the work is complete and documented.
Done is not a payment state. An order can be Done while a payout is still settling. Check the offer on the order for where the money is.
Cancelled
Cancelled means the order was stopped and will not be completed. Cancel when the customer withdraws, the job turns out not to be possible, or the order was created in error.
Cancelling stops the workflow. Outstanding steps stop asking for action, and anyone dispatched is notified. What has already happened stays on the order: bookings, photos and offers are kept, so the record of why it was cancelled survives.
Confirmed offers are not voided by cancelling. Settle or refund them deliberately.
Moving between statuses
Pending ──▶ Done every workflow step finished
Pending ──▶ Cancelled stopped by a person
An order can only leave Pending. Done and Cancelled are final: to restart work, create a new order.
Reading status over the API
The API reports status as PENDING, DONE or CANCELLED. Treat any other
value as unknown rather than mapping it to a status you recognise.
Related
Was this helpful?