Order status vs payment status

Overview

• Order status describes the operational lifecycle. Current order states include DRAFT, OPEN, CLOSED, VOIDED, CANCELLED, and FAILED.
• Payment status describes money settlement. Current order-level payment states include UNPAID, PENDING, PARTIALLY_PAID, PAID, PARTIALLY_REFUNDED, REFUNDED, and FAILED.
• These two dimensions are deliberately separate. For example, an order can be OPEN while already PAID, or CLOSED after kitchen completion while its payment state still needs attention.
• Use the current Order payment status and individual payments when deciding whether more money is still due.

When to use this

• Read this whenever a staff member says an order is 'complete' or 'paid' without specifying whether they mean service completion or money settlement.

Step-by-step

1. Read Order status to understand whether the order is still being prepared/operated, finished, voided, cancelled, or failed.
2. Read Payment status to understand whether money is unpaid, pending, partial, paid, partially refunded, fully refunded, or failed.
3. Open the individual payments when the order is PENDING, PARTIALLY_PAID, PARTIALLY_REFUNDED, REFUNDED, or otherwise unexpected.
4. Do not alter an order just to make the two labels visually match; resolve the actual operational or payment issue instead.

Common mistakes

• CLOSED is not a synonym for PAID.
• PAID is not a synonym for CLOSED.
• VOIDED/CANCELLED orders are not normal refund candidates; settled money must be handled through the appropriate payment/refund path before destructive lifecycle actions.

Troubleshooting

• If statuses appear inconsistent, review the latest payments first and use the payment recovery tools rather than changing the order manually.
• If a provider transaction is uncertain, resolve that provider attempt before deciding the final payment state.