Payments & sales
Checkout
This manual is a draft and may change.
What it does
Checkout is the part of your website that takes an order and gets paid. It keeps a record of every order, what was paid, what was refunded, and whether the goods have been shipped, picked up or downloaded. Customers can pay by the methods you switch on, and you can follow each order from payment to delivery.
Who uses it
- Customers pay at your checkout, look at their past orders, and open their digital downloads.
- Staff (admins, commerce managers and viewers) use the Orders tab to find and read orders.
- The business owner decides which payment methods are on and can pause all new payments in one step.
Setup
- Ask your 1vsM contact to install Checkout on your site.
- Tell your 1vsM contact which payment methods you want (Square or PayPal (Stripe on request), or pay in person). They connect your accounts.
- Make sure every product or service you sell has a price set on your site. Prices always come from your site, never from the customer's browser.
- Check that payments are switched on. They are on by default, and your site also checks that you are in test mode or live mode as intended.
- If you sell digital files (PDFs, audio, ebooks), ask your 1vsM contact to attach them to the product. They are stored privately, never at a public web address.
- Place one test order in test mode and confirm it shows up in the Orders tab.
Admin tasks
Checkout adds an Orders tab to the admin menu for staff with the admin, commerce manager or commerce viewer role. The tab is read only: it lists orders and shows one order in full, but it has no refund, status or shipping buttons. Refunds are issued in your payment provider's own account.
Find an order
- Open Orders. The status chips filter the list by payment status (pending, processing, completed, partially refunded, refunded, failed, cancelled).
- Each row shows the order, customer, total, payment and fulfilment. Click an order reference to open it.
Read an order
- The order page shows the customer's name, email and phone, the line items, the payments, any refunds (with how much is left to refund), the fulfilment history, and a note if a payment is under review.
The older Orders page (admin accounts only)
Some sites also carry an older full-page Orders screen. It shows Total Revenue and 7-Day Revenue, the status buttons All, Pending, Processing, Completed, Cancelled, Refunded, and a box "Search by name, email, or order ref...". Open an order to see Status Timeline, Customer Information, Payment Details, Line Items, Transaction History and Notes.
- For a pending or processing order, press Mark Completed, or Cancel Order (you are asked to confirm).
- For a completed order, press Refund Order (you are asked to confirm).
- A completed order cannot be cancelled; refund it instead.
Ship or hand over an order
Neither Orders screen has a button for this yet. Moving an order through processing, ready for pickup, shipped, picked up, delivered or returned is done by your developer through the site's order service, and the Orders tab then shows it under the fulfilment history. The rules are the same: "shipped" needs a carrier and tracking number (a tracking link must start with https), an unpaid order needs a written override reason, and a refunded or cancelled order can never be released.
Member view
Customers see an Orders list with Order, Date, Status and Total for their own orders, and "You have no orders yet." when there are none. Each order reference opens that order. Customers with digital goods can open their own download links, which expire after a short time. Customers never see anyone else's orders.
Styling it to your brand
This app takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake. That one profile applies to every app automatically, so there is nothing to set up here.
Troubleshooting
- "Order total must be greater than zero." The order had no priced items. Check that the product has a price on your site.
- "Line item ... item cannot be priced." The site could not find a price for that item. Ask your 1vsM contact to check the product's price.
- Customers cannot pay, or a method is missing. New payments may be switched off for the site or for that provider, or the site is in the wrong mode (test versus live). Check with your 1vsM contact.
- "Cannot cancel a completed order. Use refund instead." Use Refund Order for a paid order.
- Your developer cannot move an order to shipped or picked up. The order has not been paid. Either wait for the payment, or type an override reason if you are sure.
- A download link stopped working. Links expire quickly, run out after the allowed number of downloads, and stop after a refund. Ask the customer to open it again from their orders.
- The Orders tab does not show for you, or the older Orders page answers "not allowed". The tab needs the admin, commerce manager or commerce viewer role; the older page needs a site admin account.
FAQ
Can the customer change the price? No. Prices are always worked out on your site, so nothing a customer's browser sends can change a price.
What happens if a payment notice arrives twice? It is counted once. The order is marked paid once and a single payment is recorded.
Does it send emails to buyers? Only if your site has turned buyer emails on. Ask your 1vsM contact if you want them.
Can I take a partial refund? Yes. The order then shows as partially refunded, and the full refund shows as refunded.
Can I pay in instalments? Square can split an invoice into scheduled payments, which Square emails to the customer; some options need a paid Square Invoices plan. Ask your 1vsM contact before offering it.
What to connect
These accounts make the app work with your own services. Enter them once in Set up your site in your account.
- Stripe payments — optional. Card checkout through your own Stripe account (only on sites built with Stripe checkout).
- PayPal payments — needed. Checkout, deposits, tickets and donations paid by PayPal or Venmo, into your own PayPal business account.
- Square payments — needed. Checkout, deposits, tickets, donations and in-person sales into your own Square account.