Orders and order status

Your orders live in Stripe. This page is a working view onto them, plus the one thing Stripe cannot know: which ones you have actually sent.

Where the list comes from

Orders sits under Bang! Cart in the WordPress sidebar, with a count beside it while orders are waiting to go out. It fetches your 25 most recent completed payments live from Stripe each time you open it, and caches them for 60 seconds so a page refresh is not another round trip.

The Orders page: the taken-all-time total with its Recount button, and recent test orders with Mark posted buttons
A live list from Stripe, with your all-time takings counted above it.

Only orders taken through Bang! Cart

One Stripe account often takes payments from more than one place - a payment link, an invoice, another plugin, another website. The Orders page, the takings banner and Pro's Reports count only orders taken through Bang! Cart on this site. From 3.9.0 every order is stamped with the site it came from; older orders are recognised by Bang! Cart's own return address. Only those get your order emails, too: Stripe tells your site about every checkout on the account, and anything else is noted in the connection log on the Stripe tab and left alone.

Moved your shop to a new domain? Orders taken on the old address before the move are no longer counted here. They are still in your Stripe dashboard.

It follows whichever key is active. A test key shows test orders, a live key shows live ones, and the two are cached separately so switching modes never leaves test orders sitting under a live key.

What this site stores, and what it does not

The plugin creates no custom database tables. What it keeps locally is small and specific:

  • Which orders you have marked as posted or collected. The newest 500.
  • A ledger of which orders have already been emailed, so a Stripe retry cannot send a customer two confirmations. The newest 300.
  • The last ten email send attempts.
  • The last reason Stripe refused to start a checkout.
  • Short-lived caches of the order list.

The order records themselves are Stripe's. One truth beats two.

Working through orders

When orders are waiting, a blue notice above the list says how many - 3 orders to go out - with a Show only these button that hides everything already sent. Press it again to see them all. With nothing waiting the card heading says All caught up. Unmarked orders sort to the top.

Each row has one button, which is the page's whole job: Mark posted, or Mark collected on a collection order - the row knows which kind it is, and a collection row's Delivery column says Collection in person rather than showing an address. The button posts the state it wants rather than flipping whatever is there, so refreshing the page cannot quietly un-mark an order. Once marked, the row turns pale green and the button becomes a green ✓ Posted label with a small Undo beside it, for the day you press the wrong one - one press, on a phone too.

An order with nothing to send - a download on its own, a deposit - has no button at all. Its row says Nothing to post, it is not counted as to go out, and it never turns amber.

Everything occasional sits behind a … menu, so the daily job is the only button left standing:

ActionWhat it does
Resend confirmationRebuilds the buyer's confirmation from Stripe and sends it again. Asks you first, because a misclick mails a customer a duplicate.
ReceiptDownloads the plugin's PDF receipt for that order.
Open in StripeOpens the payment in your Stripe dashboard, in the right mode.

The menu opens without JavaScript, which is why it works reliably. Script only adds the manners: one open at a time, close on an outside click or Escape.

The Receipt download works even when customers are not sent one. If your document setting is None, you can still pull a receipt for your own records.

Marking an order posted from your email

Your seller notification carries a Mark as shipped button, or Mark as collected for a collection order. Clicking it opens a small confirmation page, and only pressing the button there changes anything.

That extra step is not caution for its own sake. Outlook Safe Links, spam scanners and antivirus all pre-fetch links in emails. A one-click link that acted immediately would mark orders shipped the moment the email arrived.

Bang! Cart Pro: notes appear on the page you pack from. If your products or your basket ask the customer a question, the answers print on the Mark as shipped page you open while making the parcel up - which is the screen where you actually need to read them. Three of the same mug with three different names sit as three separate lines, all drawn from one stock count. See Order and product notes.

Last checkout failure

If Stripe ever refuses to start a checkout, the customer sees a plain apology and you get the actual reason, in a red notice at the top of the Orders page: Stripe's own error message (open Details for, the parameter it objected to), and how long ago it happened.

You are emailed as well, so you need not be looking at the Orders page to find out. The email goes to the address your order emails go to (or the site admin if that is blank) and says when it happened, whether the shop was in test or live mode, what Stripe said with its error code and parameter, and links straight to this card. No customer details are in it. You get one email per distinct fault an hour, however many customers meet it - a broken setting does not fill your inbox - and if the email itself cannot be sent, the customer's checkout is no different for it.

The card clears itself the next time a checkout succeeds. A 500 with no detail is the difference between a five minute fix and a lost afternoon.

The customer's order status page

Every confirmation email carries a Check order status button. No account, no password, nothing to type.

The link is signed with a secret held on your site, so it cannot be guessed or altered. There is deliberately no lookup form anywhere: an order reference plus a guessed email address is a weak secret and an enumeration tool, so the signed link is the only way in.

What it tells them

HeadingWhen
Being preparedYou have not marked it yet. A collection order points the customer at the collection details, shown on the page.
On its wayYou marked it posted. Shows the date you did.
CollectedYou marked a collection order collected. Shows the date, the same way.
We cannot reach our payment providerStripe did not answer. The order is safe and the page says so, rather than implying it has gone missing.

It shows the order reference, the items, the total paid, and how it is coming to them. It deliberately does not show their name or their full address. The link lives in an email indefinitely and may be forwarded, so it carries only what a stale link can safely reveal, with at most a short delivery hint like "Delivering to Cambridge" - the town, or failing that the outward half of a postcode, or just the country.

Refunds

Refunds happen in Stripe. There is no refund button in this plugin, and that is a decision rather than an omission: the money is Stripe's to move, and two places to refund from is one place too many.

Refund from your Stripe dashboard and Stripe emails the buyer automatically, provided Refunds is ticked under Settings, Business, Customer emails. The plugin creates a Stripe customer record on every order specifically because Stripe requires one before it will send that email.

Still stuck?

Write to me and it is me who answers, not a ticket queue. Tell me what you expected and what happened instead.

Ask a question

Bang! Creative Family

Bang! Plugins is part of a small UK creative group, so the plugins are made and backed by people who do this for a living.