Orders and Invoices

Every purchase in BadgerPanel creates an order and an associated invoice. Orders track what the customer bought, while invoices track the payment status.

---

Order Flow

1. Customer selects a product from the storefront and chooses their preferred billing cycle and any configurable options.
2. Checkout - the customer reviews their order, applies any coupon codes, and selects a payment method.
3. Payment - the customer completes payment through the selected gateway (Stripe or PayPal).
4. Provisioning - if auto-activate is enabled, the server is created automatically once payment is confirmed. If auto-activate is disabled, an admin must manually approve the order.

---

Invoice Statuses

Each invoice moves through one of the following statuses:

Status	Description
Draft	The invoice has been created but not yet finalized or sent to the customer
Pending	The invoice is active and awaiting payment
Paid	Payment has been received and confirmed
Overdue	The invoice has passed its due date without payment
Cancelled	The invoice has been cancelled and no payment is expected
Refunded	The payment was refunded to the customer

---

Viewing Orders

Navigate to Admin > Billing > Orders to see all orders. The order list shows:

• Order number
• Customer name
• Product name
• Total amount
• Order status
• Date placed

Click any order to view its full details, including the associated invoice, server (if provisioned), and payment history.

Filtering Orders

Use the filters at the top of the orders page to narrow results by:

• Status - filter by order status
• Customer - search by customer name or email
• Product - filter by product type
• Date range - show orders from a specific time period

---

Viewing Invoices

Navigate to Admin > Billing > Invoices to see all invoices. The invoice list shows:

• Invoice number
• Customer name
• Amount
• Status
• Due date
• Payment date (if paid)

Click any invoice to view line items, payment method details, and transaction history.

Filtering Invoices

Filter invoices by:

• Status - show only paid, pending, overdue, etc.
• Customer - search by customer name or email
• Date range - filter by issue date or due date

---

Manual Actions

Administrators can perform the following manual actions on invoices:

Mark as Paid

Manually mark an invoice as paid when payment was received outside the panel (bank transfer, cash, etc.). This updates the invoice status and triggers server provisioning if applicable.

1. Open the invoice.
2. Click Mark as Paid.
3. Confirm the action.

Cancel

Cancel an invoice that is no longer needed. This does not refund any payment - use this for invoices that were created in error or are no longer relevant.

1. Open the invoice.
2. Click Cancel.
3. Confirm the action.

Refund

Issue a refund for a paid invoice. The refund is processed through the original payment gateway.

1. Open the invoice.
2. Click Refund.
3. Confirm the refund amount and submit.

The invoice status changes to Refunded and the payment is returned to the customer through the original payment method.

---

Next Steps

• Service Lifecycle - what happens after payment
• Credits - account balance system
• Coupons - discount codes