Commerce
A catalog, a cart and a checkout that live on your own website, with every order priced and confirmed on the server.
Commerce is a catalog, a cart and a checkout that live on a website you already have, or on one Xuda builds for you. Buyers never leave your page: the shop is drawn into it, the cart slides in from the side, and the payment form is on your own checkout page.
The server prices every order, a cart line is a product, a variant and a quantity, and price, discount, shipping and total are worked out on our side every time, and again at the moment of payment. Nothing a buyer's browser sends can change an amount. And Xuda is not the merchant, a charge goes straight to your own finance account, the money, the refunds and the disputes are yours.
Commerce ships as a built-in app rather than something you assemble from Studio progs yourself, it has no Studio, .xu or JSON source form of its own the way the rest of this section does.
Stores
A store is one catalog with one cart. Most sellers need one, a seller with two very different lines makes two.
- Active stores trade, paused stores stop trading but keep their place on your plan, so you can switch them back on with everything as it was.
- Archive a store from its Settings tab to stop it and hand its slot back to your plan, nothing is deleted, and you can restore it from the Archived tab. An archived store can be deleted for good from that same tab.
- Every store has a buyer-facing name, a currency, and the finance account its money goes to (Settings, "Getting paid").
Products
Products are physical, digital or a service, each with a title, a description, a price, pictures, and optional variants (size, colour) with their own prices and stock.
- Pictures come from your Drive, pick one or drop a file straight onto the product, it is stored under a folder Commerce keeps for the store.
- A product is draft until you make it active, only active products appear in a shop.
- Stock is reserved when a buyer goes to pay, not when they add to the cart, so nobody can empty your availability by filling carts.
Storefronts
A storefront is a website of yours where the shop appears. Creating one takes three fields: a storefront name, the website address (only the host is kept, www is dropped), and whether the shop should refuse to appear anywhere but that domain and its subdomains (on by default, switch it off to also run on a staging or preview site).
You get one tag:
Paste it once, just before the closing body tag, on any page of that site, the product grid, the cart and the checkout appear on their own. Each storefront has its own key, so removing one site never touches another, and the Preview button shows the shop running on Xuda's host before you have pasted anything.
To put a buy button on a page you already have instead of the whole grid, add a button with the product's SKU:
No website yet, "Let Xuda build one for you" opens the website builder with the store attached, and the shop is drawn into the pages it generates.
Checkout and payments
The cart's Pay button opens a checkout page on Xuda's host that belongs to your store: the address, the delivery choice, the discount code and the card form. Cards are taken with Stripe Elements on that page, so card details never touch your site or Xuda's.
- A buyer can pay only when the store has a finance account connected, the shop says so before anyone has typed anything, rather than at the pay button.
- Payment status is confirmed from the payment provider, never from the browser, the same confirmation runs from the provider's webhook, so a buyer who closes the tab after paying still gets their order.
- Orders carry three separate statuses: the order itself (pending, open, completed, cancelled), the payment (unpaid, authorized, paid, partially refunded, refunded, disputed, failed) and the fulfilment (unfulfilled, ready to ship, partially shipped, shipped, delivered, returned). "Paid" says nothing about shipping, and that is on purpose.
Discounts
Each discount is either a code the buyer types or an automatic discount that applies itself, and takes off a percentage, a fixed amount, or the shipping.
A discount can be limited to a minimum order value or quantity, to certain countries, to one use per customer, to a total number of uses, and to a date range. Only one discount is ever applied to an order: when several automatic discounts qualify, or a typed code and an automatic discount both do, the buyer gets whichever is worth the most, they never stack. Free shipping can be capped to a maximum rate so an overnight courier is not free by accident.
Orders
The Orders tab lists what the store sold, what was paid, and what shipped. Open an order to see its lines, totals, the buyer, the payment and a timeline. Ship it from the order page or the list, Xuda Shipping creates the delivery and the buyer's tracking appears on the order and in their portal.
Create a draft order
For a phone order, an invoice, or a deal agreed elsewhere, add products from the catalog or a custom line with its own price.
Set the buyer and terms
Email and address, a discount and a shipping charge, the server reprices as you go.
Collect payment
Send invoice emails the buyer a link to pay, Collect payment takes the card right there in the dashboard for a buyer on the phone. A draft gets its order number the moment it is paid.
Customer portal
A store's customer portal is a page where a buyer signs in with nothing but the email they ordered with and sees their orders, their payments and their deliveries. It is set up in the Portal module, as a portal for the store made from Store account: switch it on there, copy its link, and put it in your order emails or on your site.
- Sign-in is a six-digit code sent to the buyer's email, no password to forget, codes work for ten minutes, sessions last a day.
- Orders shows their paid orders with lines, totals, the delivery address and tracking, drafts and abandoned checkouts never show.
- Payments shows what they paid, when, the card that paid (brand and last four digits) and a link to the receipt.
- Deliveries shows the parcels from their orders, with the carrier, the tracking number and how far each has come.
The portal's own page gives you the rest: its logo, its accent colour and its links, and Portal settings issues a new link that retires the old one at once.
The portal is not tied to Commerce alone, the same mechanism will front Shipping (a recipient's deliveries) and Tickets (a requester's tickets), so a customer of yours signs in the same way everywhere.
Fees and plans
Each plan sets how many stores you can run, how many discounts a store can hold, and the fee per order, if any. Paused stores count against the plan, archived ones do not. What your plan takes is shown on the store's Settings tab next to what the store sold this month.