boxcart.dev

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.

StatusDescription
PendingThe 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.
ProcessingThe 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.
ReadyAll 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.
CompletedThe customer has collected their order. The order is finalised and archived.
CancelledThe order has been cancelled by the store or the customer. Always available and cannot be disabled.
Orders screen opening on Upcoming: collection-day buttons with order counts, status tabs, the search box, the sentence 22 orders for collection today or later, soonest first, and the order table
Configurable statuses

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.

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 StatusDescription
Not RequiredNo payment is needed for this order. This is the default when the payment system is disabled.
PendingPayment is expected but has not yet been initiated. Used for cash on collection orders.
Awaiting PaymentThe customer has been given payment instructions (e.g. bank transfer details) and the store is waiting for funds to arrive.
ProcessingPayment is being processed by the payment gateway (e.g. Stripe is handling the transaction).
PaidPayment has been successfully received and confirmed. A part refund leaves the order Paid, with the amount refunded shown on the order.
Part paidThe 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).
FailedThe 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.
RefundedEverything the customer paid has been refunded.
CancelledThe payment was cancelled before completion.
Tip

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:

ButtonShows orders for collection
UpcomingToday and later, soonest first. This is where the screen opens.
TodayToday.
TomorrowTomorrow.
This weekFrom today to the end of the week. The week starts on the day set under Settings → General in WordPress ("Week Starts On").
Next weekThe whole of next week.
Any dayEvery order, whatever its collection day, newest first.
Pick a dayOpens a calendar: choose any day, or open Between two dates and choose a From and To date for a longer stretch.
Orders screen with Pick a day open: a November calendar with the weeks starting on Monday, today's date ringed, and Between two dates underneath

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.

Before 1.8.0

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.

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:

Status change logging

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.

A cancelled order whose card payment has been refunded, with the Delete order link under Update Status

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 Cancelled tab with two cancelled orders ticked and the Delete for good button above the list

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.

BoxCart Today widget: a warning that one order's shop email didn't send with a Resend button, the day picker, today's seven collections and revenue, five orders and a +2 more link

Since 1.8.0 the widget also has:

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

Order items

An itemised list showing each product ordered, including:

Collection details

Payment information

A sidebar card displays the payment details when payments are enabled:

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.

Order detail view showing customer info, items, collection details, and status log

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.

Order screen for a card payment, with £3.80 entered under Refund to card in the Payment box

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.

Money paid in person

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:

FormatIncludes PricesBest For
Pick ListYesInternal use, with the full order details and prices
Pick List (No Prices)NoInternal use, when the people picking don't need the prices
Packing SlipNoIncluding 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.

Pick lists for three orders: Back to Orders and Print in BoxCart green, then an order with its customer, collection details, and items with quantities like ×2 kg, prices and totals

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.

Tip

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.

SettingDefaultDescription
Order Number PrefixBCA 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 Start1The starting number for order numbering. Accepts a value between 1 and 999999. Only applies to new orders created after the setting is changed.
Warning

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.

  1. View a past order

    The customer navigates to their account and opens their order history, or views a specific past order.

  2. Click "Reorder"

    A Reorder button appears on past orders. Clicking it adds all items from that order to the current basket.

  3. 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

SettingDefaultDescription
Allow order modificationsOffMaster toggle to enable or disable the feature.
Modification window24 hoursEither 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 quantitiesOnAllow 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 cardOnLets 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 slotOnAllow customers to change their collection date and time slot.
Customer notesOnAllow customers to update the notes attached to their order.

How it works

  1. 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).

  2. 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.

  3. 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.

When a customer changes the items on an order they've paid for by card, BoxCart puts the money right:

A card-paid order the customer changed to cost more: Part paid, £14.90 paid and £6.20 to pay at collection, with the Confirm Balance Received button

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.

Warning

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.