Order Statuses
Complete reference of order and payment statuses in Harvenci.
Order Status Flow
Standard Order Flow
Pending ApprovalConfirmedProcessingReady for PickupCompleted
Order Statuses
| Status | Internal Value | Description |
|---|---|---|
| Pending Approval | pending_approval | Order placed but waiting for merchant approval. Used when manual confirmation is enabled. |
| Confirmed | confirmed | Order has been approved and accepted by the merchant. |
| Pending | pending | General pending state. Often used when awaiting payment confirmation. |
| Processing | processing | Order is being prepared. For restaurants, food is being made. |
| Ready for Pickup | ready_for_pickup | Order is ready and waiting for customer to pick up. |
| Completed | completed | Order has been fulfilled. Customer has received their items. |
| Cancelled | cancelled | Order was cancelled by merchant or customer. |
Payment Statuses
| Status | Internal Value | Description |
|---|---|---|
| Paid | paid | Payment received (via Stripe or COD marked as paid). |
| Pending | pending | Awaiting payment. Used for COD orders before pickup. |
| Failed | failed | Payment failed (card declined, session expired, or checkout abandoned). |
| Refunded | refunded | Payment was refunded to the customer. |
Allowed Transitions
Orders can only move to certain statuses from their current state.
From Pending Approval
- → Confirmed (approve order)
- → Cancelled (reject order)
From Confirmed
- → Processing (start preparation)
- → Cancelled (cancel order)
From Processing
- → Ready for Pickup (mark ready)
- → Cancelled (cancel order)
From Ready for Pickup
- → Completed (customer picked up)
- → Cancelled (cancel order)
Terminal States
Completed and Cancelled are terminal states. Orders cannot be changed after reaching these statuses.
Customer Notifications
Customers receive WhatsApp notifications for these status changes:
- • Order placed → Confirmation message
- • Pending → Confirmed (approved)
- • Pending → Cancelled (rejected)
- • Processing → Ready for Pickup
- • Any status → Completed
- • Any status → Cancelled