Overview
This guide covers the complete order management flow, from cart validation to order completion. Understanding this process is crucial for building a reliable storefront.Order Flow Overview
1. Cart Validation
Before accepting payment, validate the cart:2. Payment Processing
Create payment intent and handle payment:3. Order Creation
Orders are automatically created when payment succeeds:4. Order Status Management
Order States
Orders can have these states:pending
- Order created, waiting for restaurant confirmationconfirmed
- Restaurant confirmed the orderpreparing
- Order is being preparedready
- Order is ready for pickup/deliverycompleted
- Order has been fulfilledcancelled
- Order was cancelled
Status Updates
5. Customer Communication
Order Confirmation
Status Updates
6. Error Recovery
Payment Failures
Order Creation Failures
7. Testing Order Flow
Test Scenarios
Best Practices
- Always validate carts before payment
- Handle payment failures gracefully
- Provide real-time order updates when possible
- Log critical errors for debugging
- Test edge cases thoroughly
- Keep customers informed throughout the process