Everyone

Order Lifecycle

Understand the full status flow of an order from creation to completion or cancellation.

Last updated 1776211200

Status Flow

Client/Admin creates order
          │
          ▼
       [pending] ◄─── Invoice generated immediately
          │
     Invoice paid?
       /       \
      No       Yes
      │         │
  remains    Auto-approve ON?
  [pending]    /        \
              Yes        No
              │           │
           [active]   stays [pending]
                          │
                     Admin reviews
                      /         \
                 Approve        Reject
                    │               │
                [active]      [fraud] or [cancelled]

What Creates an Order

  • Client checkout: Client completes the order form at /store, invoice is generated, redirected to payment.
  • Admin on behalf of client: Admin → Clients → [client] → New Order → select product and cycle → invoice generated.

Order Statuses

Status Description
pending Order placed, invoice not yet paid — or paid but awaiting manual admin approval
active Invoice paid and order approved; services have been created and provisioned
fraud Manually flagged by admin as fraudulent; no services provisioned
cancelled Order cancelled before completion; no services provisioned

What Happens on Invoice Payment

When the invoice linked to an order is marked as paid:

  1. Commerce checks the Auto-approve orders setting.
  2. Auto-approve ON: Order moves to active immediately. Service creation and provisioning jobs are dispatched.
  3. Auto-approve OFF: Order stays pending. Admin receives a notification. Order must be approved manually at Admin → Orders.

See Order Approval for more on the two modes.


What Happens on Order Activation

When an order transitions to active:

  1. A service record is created for each ordered product.
  2. For hosting type products, a CreateAccount provisioning job is dispatched to the queue.
  3. Once provisioning succeeds, the service status moves from pending to active.
  4. The welcome email is sent to the client.

Invoice Generation Timing

An invoice is generated at order creation — not at payment, not at approval. The invoice is in unpaid status until the client pays. This means:

  • An order can sit in pending for days while the client decides to pay.
  • If the invoice expires (configurable invoice due date), the order may be auto-cancelled depending on your settings.

Admin Order List

All orders are visible at Admin → Orders with filters for status, client, and date range. See Managing Orders in Admin.


Related Articles