Order Lifecycle

This page documents order states, transition rules, review flags, and manual/offline payment handling.

Core states

• pending
• paid
• fulfilled
• refunded
• canceled

Invalid transitions are blocked (for example paid -> pending). Terminal states such as refunded and canceled are protected.

Payment integrity and review flags

After webhook processing, received payment amount is compared against order totals. Significant variance triggers a review flag (needs_review) so staff can inspect before fulfillment.

Typical review reason:

• payment_amount_mismatch

Manual transactions (offline methods)

For COD and bank transfer orders, admins can record manual payments:

1. Open order details.
2. Use Record Payment.
3. Enter amount/reference/note.
4. Save to move order from pending to paid.

Manual payments are logged for audit tracking.

Customer-facing order pages

• Public order status: secure links for guest access.
• My Orders: authenticated customer order list/detail.
• Tracking updates: exposed on order view after fulfillment actions.

Stale order cleanup

The scheduled cleanup task can cancel old pending orders and release reserved stock.

Key settings:

• Enable cleanup
• Threshold in hours (default 48)
• Schedule via Joomla Scheduled Tasks