Orders
Every order placed through your BoxCart store follows a clear lifecycle from creation to completion. This guide covers how orders work, how to manage them, and the tools available for printing, reordering, and modification.
Order Lifecycle
BoxCart uses a linear status flow that tracks each order from the moment it is placed through to completion. The primary path is:
Pending → Processing → Ready → Completed
At any point before completion, an order can also be moved to Cancelled as a side branch.
| Status | Description |
|---|---|
| Pending | The order has been placed and is awaiting action from the store. This is the default status for new orders. Always available and cannot be disabled. |
| Processing | The store has acknowledged the order and is preparing the items for collection. You set this status yourself: a payment being confirmed (by Stripe or by you) records the order as paid but doesn't move it here. |
| Ready | All items have been picked and packed. The order is ready for the customer to collect. A "Ready for Collection" email is sent to the customer. |
| Completed | The customer has collected their order. The order is finalised and archived. |
| Cancelled | The order has been cancelled by the store or the customer. Always available and cannot be disabled. |
You can choose which statuses are enabled in BoxCart → Settings → Orders. The Processing, Ready, and Completed statuses can each be toggled on or off. Pending and Cancelled are always available. The default status for new orders is configurable and defaults to "Pending".
Completing orders after the collection day
If your team doesn't move every order on to Completed, the order list fills up with orders that were collected long ago. Since 1.7.0, turn on Complete orders after the collection day under BoxCart → Settings → Orders → Status Workflow (off by default). Once an hour, BoxCart marks any Pending, Processing or Ready order whose collection date has passed (in your site's timezone) as Completed, and notes "Completed automatically after the collection day" in its history.
- Customers aren't emailed, and the payment status isn't changed.
- Cancelled orders, and card orders still waiting for payment, are left alone.
- Older orders are caught up the first time it runs, a batch at a time.
BoxCart's daily tidy-up keeps a completed order's history for 90 days, so completing old orders also trims their older history notes over time. Developers can stop status emails for any change with the boxcart_queue_status_email filter (see Hooks & Filters).
Payment Statuses
BoxCart tracks payment status separately from order status. This allows you to see at a glance whether an order has been paid, regardless of where it is in the fulfilment process. The "Payment Status" column appears in the orders list when payments are enabled.
| Payment Status | Description |
|---|---|
| Not Required | No payment is needed for this order. This is the default when the payment system is disabled. |
| Pending | Payment is expected but has not yet been initiated. Used for cash on collection orders. |
| Awaiting Payment | The customer has been given payment instructions (e.g. bank transfer details) and the store is waiting for funds to arrive. |
| Processing | Payment is being processed by the payment gateway (e.g. Stripe is handling the transaction). |
| Paid | Payment has been successfully received and confirmed. A part refund leaves the order Paid, with the amount refunded shown on the order. |
| Part paid | The customer changed an order they'd paid for by card so that it costs more. The rest is paid at collection (BoxCart Pro, see Changes to paid orders). |
| Failed | The card payment didn't go through. The customer keeps their basket to try again; the unpaid attempt is cancelled without any emails and stays in your order list. |
| Refunded | Everything the customer paid has been refunded. |
| Cancelled | The payment was cancelled before completion. |
For bank transfer orders, a "Confirm Payment Received" button appears on the order detail view. Clicking it sets the payment status to "Paid" and sends the customer a "Payment Received" email. The order status doesn't change: move it on when you start preparing the order. The button also appears on cash on collection orders, and as "Confirm Balance Received" on part-paid orders once the customer has paid the rest.
Managing Orders
The orders list is your central hub for day-to-day order management. Navigate to Admin → BoxCart → Orders to access it.
Administrators and your shop staff (1.6.0) can manage orders: everything on this page, including refunds and messages on Pro, except deleting cancelled orders, which stays with administrators along with Settings.
Finding orders by collection day
Since 1.8.0 the Orders screen is organised around the day customers collect. It opens on Upcoming: today's collections and later, soonest first. A row of buttons above the list changes the days in one click, and each button shows how many orders it has:
| Button | Shows orders for collection |
|---|---|
| Upcoming | Today and later, soonest first. This is where the screen opens. |
| Today | Today. |
| Tomorrow | Tomorrow. |
| This week | From today to the end of the week. The week starts on the day set under Settings → General in WordPress ("Week Starts On"). |
| Next week | The whole of next week. |
| Any day | Every order, whatever its collection day, newest first. |
| Pick a day | Opens a calendar: choose any day, or open Between two dates and choose a From and To date for a longer stretch. |
- One day at a time: while one day is showing (Today, Tomorrow or a day you picked), the ‹ and › arrows step back or forward a day.
- Status tabs: the tabs (All, Pending, Processing, Ready, Completed, Cancelled) narrow the chosen days down by status, and their counts follow the days you've chosen.
- Collection point: with more than one location (Pro), a dropdown shows one collection point's orders.
- Search: search by customer name, email or order number.
Everything applies straight away; there's no Filter button. A sentence above the list always says what you're looking at, for example "7 orders for collection today, Monday 2nd November" or "2 orders, any collection day, marked "Cancelled"". Show all orders next to it clears everything. Results are paginated at 20 orders per page with sortable columns.
The +2 more link in the BoxCart Today widget and the links in the daily collections email open that day here. Older links and bookmarks that used the From and To date boxes still work.
The Orders screen used to open on every order, newest placed first, with From and To collection-date boxes and a Filter button. The export went by the date orders were placed; it now goes by collection date, like the rest of the screen.
Exporting orders
Click Export at the top of the Orders screen to download orders as a spreadsheet. Order export is part of the free plugin.
- Collection dates: a From and To date. They start with the days you're looking at, so exporting from Tomorrow exports tomorrow's orders. Leave a date empty for no limit.
- Order Status and Location: all, or just one.
- Format: CSV or Excel (XLSX).
Each row has the order number, the date it was placed, its status, the customer's name, email and phone, the collection point, date and time, the number of items, subtotal, discount, total and notes. Since 1.8.0 the export filters and sorts by collection date (before, it used the date the order was placed).
Since 1.8.0 the Excel option makes a real Excel file, so Excel and Numbers open it without a warning. Amounts are numbers you can add up, and text such as a name starting with "=" shows as plain text rather than running as a formula. On a server without PHP's ZipArchive extension, you get the CSV instead.
Changing order status
From the order detail view, use the status dropdown to advance an order through the lifecycle. Each status change is:
- Logged in the order's status history with a timestamp, the previous status, the new status, and the user who made the change
- Triggers a status-change email to the customer (e.g. "Order Ready for Collection")
Every status change is recorded in the boxcart_order_status_log table. This provides a complete audit trail showing who changed the status, when it was changed, and what the previous status was.
Deleting orders
Cancelled orders, such as test orders or unpaid card attempts, can be deleted. Open the order and click Delete order under Update Status. The button only appears once an order is cancelled, so cancel it first. While part of a card payment can still go back to the customer, refund it before deleting. If the order shows money paid in person, BoxCart reminds you to settle it with the customer first.
Deleting removes the order, its items and its status history (and, on Pro, its messages), so it disappears from your orders and reports. It can't be undone.
Several at once (1.8.0): open the Cancelled tab, tick the orders, and choose Delete for good. BoxCart asks first. Orders with card money still to refund are left alone, and the notice tells you how many weren't deleted, so you can open them to see why. The button only appears on the Cancelled tab, and only for administrators: shop staff don't see it.
The BoxCart Today widget
The BoxCart Today widget on your WordPress dashboard shows the day's collections at a glance: how many there are, the day's revenue, and the next few orders with their collection time, customer, item count and status. View all orders opens the Orders screen, and the line at the bottom counts the rest of the week's orders by status.
Since 1.8.0 the widget also has:
- A day picker: the ‹ and › arrows step a day at a time, Today and Tomorrow jump straight there, and the calendar button opens any date. The figures and the list follow the chosen day; a day with no orders says "No collections on Wednesday 11th November."
- Items to pick: if your shop doesn't show prices (Settings → General), the widget shows how many items there are to pick instead of revenue.
- +N more: the list shows five orders. With more that day, a +2 more link opens the rest on the Orders screen.
- Quieter labels: when every order in the list is at the same status, the status labels go quiet. They stand out again once some orders move on.
- A warning when a shop email didn't go: if the new order email to your shop wasn't sent for an order placed in the last week (checked 40 minutes after the order), the widget says "1 order from the last week didn't send its shop email, so you may not have heard about it." View it opens the order and Resend sends the email again. Only orders placed after you updated to 1.8.0 are checked.
Administrators and shop staff see the widget. What customers search for is in a separate widget, BoxCart Searches.
Order Detail View
Click any order in the list to open the full order detail view. This page displays everything you need to fulfil the order.
Customer information
- First name, last name, and email address
- Phone number (if provided)
- Link to the customer's registered account
Order items
An itemised list showing each product ordered, including:
- Product name and SKU
- Quantity and unit label (for quantity-type products)
- Price per unit and line total
- Order total, with the subtotal, discount and VAT where they apply. VAT added on top of your prices has its own line; when prices include VAT, "Includes VAT" shows under the total.
- Any amount refunded, and anything left to pay at collection
Collection details
- Collection location name and address
- Selected collection date and time slot
Payment information
A sidebar card displays the payment details when payments are enabled:
- Payment method (Stripe, Cash on Collection, or Bank Transfer)
- Payment status badge
- Amount refunded, and anything left to pay at collection
- Transaction ID (for Stripe payments)
- "Confirm Payment Received" button for bank transfer and cash on collection orders ("Confirm Balance Received" on part-paid orders)
- Pro: Refund to card for orders paid by card (see Card Refunds)
Status log
A chronological list of all status changes for this order, showing the old status, new status, timestamp, and the admin user who made the change.
Admin notes
A free-text field for internal notes about the order. The label for this field can be customised in BoxCart → Settings → Orders (defaults to "Admin Notes"). Customer-submitted order notes are displayed separately.
Card Refunds Pro
BoxCart Pro can refund card payments through Stripe without leaving the order screen. This is a Pro-only feature, for orders paid by card through Stripe. See the Free vs Pro comparison.
- Refund part or all of a payment: under Payment on the order screen, enter an amount in Refund to card (it starts at the full amount) and click Refund. You can refund up to what's been paid by card, less anything already refunded.
- Refund when cancelling: choose Cancelled under Update Status and tick Refund … to the customer's card. The refund is made first; if it doesn't go through, the order isn't cancelled and you see Stripe's reason.
- Refunds made in Stripe: refunds you make in the Stripe dashboard are recorded on the order too, through the
charge.refundedwebhook (see Stripe Webhooks). BoxCart also checks with Stripe when you open the order, so refunds made before you updated to 1.5.0 show up. - Refunds that fail later (1.8.0): now and then Stripe accepts a refund and it fails afterwards, for example because the card has been closed. Through the
charge.refund.updatedwebhook, BoxCart then adds a note to the order with Stripe's reason, puts the order's payment figures back to what Stripe says was refunded, and emails you ("A refund didn't go through"). Refund it again, or sort it out with the customer. See Failed refunds.
Each refund is noted in the order's history. The order shows the amount refunded, and its payment status changes to Refunded once everything paid has gone back. The cancellation email tells the customer how much was refunded to their card.
A refund you give from the order screen or in Stripe stays with the customer: if they change the order afterwards, it isn't taken back from what they're owed. So if you refund an item you've run out of, let the customer know, as removing that item themselves would refund it a second time.
Only money paid by card can go back to the card. If a customer paid part of an order in person (a balance paid at collection), refund that part in person: BoxCart adds a note to the order when this applies.
Pick Lists Pro
BoxCart Pro can generate printable pick lists and packing slips to help you prepare orders for collection. This is a Pro-only feature. See the Free vs Pro comparison.
Print formats
Click Print on an order to choose one of three formats:
| Format | Includes Prices | Best For |
|---|---|---|
| Pick List | Yes | Internal use, with the full order details and prices |
| Pick List (No Prices) | No | Internal use, when the people picking don't need the prices |
| Packing Slip | No | Including with the customer's order |
You can print pick lists for a single order or for multiple orders at once: tick the orders on the Orders screen and choose Print Pick Lists. The print view is a standalone page with dedicated print styles, designed to produce clean output on paper. Each order lists its items with a tick box, the quantity and the product, plus the customer, the collection day, time and place, and a "Packed by" line.
Since 1.8.0 the Qty column is wider, so quantities such as "×1 Each", "×0.5 lb" or "×10 Bunches" stay on one line and long lists take fewer pages (longer units such as "×3 Half Dozens" still wrap). The toolbar's Back to Orders link and Print button are BoxCart green.
Enable "Include Order Notes on Print" in Settings → Orders to show customer notes on your pick lists. This is useful for special requests like "please leave the apples unbagged" or allergen notes.
Order Numbering
BoxCart assigns a sequential number to each order. You can customise the numbering scheme in BoxCart → Settings → Orders.
| Setting | Default | Description |
|---|---|---|
| Order Number Prefix | BC | A prefix added to the beginning of every order number. Out of the box this is set to BC, so orders are numbered BC-0001, BC-0002, and so on. Clear it or change it to use your own prefix. |
| Order Number Start | 1 | The starting number for order numbering. Accepts a value between 1 and 999999. Only applies to new orders created after the setting is changed. |
Changing the starting number only affects orders placed after the change. Existing orders retain their original numbers. If the new starting number is lower than an existing order number, BoxCart will continue from the highest existing number to avoid duplicates.
Quick Reorder Pro
On BoxCart Pro, customers can reorder any previous order from their Order History with one click. Especially useful for regular customers who order the same items each week.
-
View a past order
The customer navigates to their account and opens their order history, or views a specific past order.
-
Click "Reorder"
A Reorder button appears on past orders. Clicking it adds all items from that order to the current basket.
-
Review and checkout
The customer is redirected to the basket or checkout page where they can review the items, make adjustments, and place the new order.
Order Modification Pro
On BoxCart Pro, customers can modify their orders within a configurable time window after placing them. This feature is disabled by default and can be enabled in BoxCart → Settings → Accounts → Order Modifications.
Configuration
| Setting | Default | Description |
|---|---|---|
| Allow order modifications | Off | Master toggle to enable or disable the feature. |
| Modification window | 24 hours | Either a number of hours after placing an order (1 to 48), or (since 1.6.0) until the order cut-off for the collection. Either way, changes close at the order cut-off. Customers are told until when they can make changes, on their order and in their confirmation email. |
| Items and quantities | On | Allow customers to change which products are in the order and adjust quantities. New items are priced at your current prices and tax is recalculated. Quantities go up and down in each product's own steps, between its minimum and maximum (for example 0.5 kg at a time), and anything off those steps is refused. |
| Let customers change items on orders paid by card | On | Lets customers change the items on orders they've paid for by card (see Changes to paid orders). Orders paid any other way keep their items locked: the customer sees a note asking them to contact you, and can still change their collection slot and notes. |
| Collection slot | On | Allow customers to change their collection date and time slot. |
| Customer notes | On | Allow customers to update the notes attached to their order. |
How it works
-
Customer views a recent order
The customer logs in, navigates to their order, and sees a "Modify Order" button if the order is within the modification window and in an allowed status (Pending or Processing). Order changes need an account: a customer who checked out as a guest creates one from their order confirmation page first (see Customers who checked out as guests).
-
Make changes
The order items are loaded into a modification view. The customer can adjust items, quantities, collection slot, or notes depending on which options are enabled. On an order paid by card, a note explains how the money will be put right.
-
Save modifications
The customer saves their changes. The order is updated via AJAX, and both the customer and the admin receive email notifications detailing what was changed.
Changes to paid orders
When a customer changes the items on an order they've paid for by card, BoxCart puts the money right:
- The new total is lower: the difference is refunded to their card through Stripe straight away. If the refund fails, the change isn't saved and the order stays as it was. If part of what they paid was paid in person, that part shows as To give back at collection. If Stripe doesn't answer, the customer is asked to try again in a minute; BoxCart checks with Stripe first, so they're never refunded twice.
- The new total is higher: the order's payment status becomes Part paid and the customer pays the rest when they collect. The order screen, the customer's emails and their order show what's left to pay. Once they've paid, click Confirm Balance Received.
Price changes
Since 1.7.0, if a product's price has changed since the order was placed, the units the customer already ordered keep the price they paid, and any extra units cost today's price. The order then lists the product twice, one line per price, for example "Apples × 2 at £1.20" and "Apples × 3 at £1.40", so receipts, emails, exports and pick lists always add up. If the customer takes units off, the most recently added come off first, so they're refunded (or owe less) at the price paid for those units. The order window shows the product once, with a note: "Price changed: now £1.40 (you paid £1.20). Extra items are charged at £1.40." Before 1.7.0 the whole line kept the old price, extra units included.
Switch off Let customers change items on orders paid by card to keep the items on paid orders locked. Orders paid by bank transfer or in person always keep their items locked.
Order modification is only permitted while the order is in the Pending or Processing status and within the configured time window. Once the window expires or the order moves to Ready, Completed, or Cancelled, modifications are no longer available. Changes also close at the order cut-off for the order's collection slot (see When Orders Close), even if the window hasn't ended.
While order modifications are on, orders aren't auto-completed: a completed order can't be changed.