Shop basics
How to build a Sorraia product widget, choose one-time, subscription, or donation selling, connect Stripe, take checkout, and track orders, subscriptions, and collections.
Create a product
Open My Shop (the /shop-widgets page) and use the + New Product menu. You can start from a Blank product, pick a ready-made template — Buy Now, Subscription, Donation, or Physical goods — or use Import products. Each choice opens the product builder, organized into a Product tab, a Design tab, and a Settings tab (team shops also get a Team tab).
In the Product tab you set the widget name (admin-facing only), the product name your buyers see, a description, an image, and the price. When you save, Sorraia gives you an embed snippet — a small script tag you paste into any page on your own site. The product updates automatically whenever you save changes here.
- You need at least one verified site before you can create a product — the page will prompt you to add or verify one first.
- Use Test as guest to preview the public product page with a sandboxed checkout that never charges a real card (save the product first).
One-time, subscription, or donation
In the Product tab you choose how the product sells, and each option changes the fields below it.
Under the Sell it heading you also pick a fulfilment type: Digital (a download link emailed automatically after payment), Service (no fulfilment from us — it just fires your webhook), or Physical (collect a shipping address, choose which countries you ship to, set a flat shipping cost, and optionally collect tax through Stripe Tax).
- Buy Now — a single one-time payment. You can let buyers choose a quantity (1–10) and add size/colour variants with their own SKUs and prices.
- Subscription — recurring monthly or yearly billing, with an optional free-trial period and optional promotion codes.
- Donation — pay-what-you-want. You offer suggested amounts, and buyers can always type their own.
- Variants only apply in a collection or cart checkout — a single-product embed always charges the top-level price.
Connect Stripe to get paid
Payments run through Stripe, so you connect a Stripe account before any checkout will work. In the builder you will see a Connect Stripe to receive payments banner — click Connect Stripe, choose the country your business is based in (Stripe locks this in when the account is created, so choose carefully), and finish Stripe's onboarding steps.
You can save widgets before connecting, but checkouts fail until onboarding is complete. You can connect one Stripe account for your whole Sorraia account, or connect a separate Stripe account per site — a site's connection receives all of that site's shop revenue, and connecting one is limited to org admins.
Checkout and fees
Buyers pay on Stripe's hosted checkout page. In the Settings tab you can set a Success redirect URL (where buyers land after paying — leave it blank to use Sorraia's built-in success page), turn on a Sorraia-branded receipt email (Stripe also sends its own), and add a Webhook URL so a JSON order payload is posted to your own stack after every paid checkout.
On each sale Sorraia takes a small platform fee — the exact rate depends on your plan — and Stripe takes its own processing fee. The builder shows a live "You receive about X per sale" estimate under the price so you can see roughly what lands in your account. Stripe's share is an estimate, because it varies by card type and country.
Orders and subscriptions
Two dashboard pages track what you sell. Orders (/orders) lists every paid checkout with a summary strip and search; you can open any order for details, mark physical orders as shipped, and export to CSV. Refunds on an order are available to org admins.
Subscriptions (/subscriptions) lists your recurring plans and their status; refunds on a subscription's charges are org-admin only. For digital products, buyers automatically receive an email with a signed download link that redirects to your file — that link is valid for 24 hours.
Group products with Collections
Use Collections (/collections) to group several products into one grid you can embed together. Click + New Collection, give it a name, and add products to it. Deleting a collection keeps the products themselves — only the grouping is removed.
A collection checks out through a cart, so buyers can add more than one item (and pick a variant where you offer them) and pay for everything in a single Stripe checkout.