Getting started

From zero to your first checkout

This guide goes from an empty workspace to a product purchasable in Stripe test mode from your own site. No plan is required for any step here, and nothing is charged: everything runs on Stripe test mode until you decide to go live.

1. Create your workspace

Sign up at /app/signup with an email, a password, and the workspace name. A workspace is one merchant with one catalog, one Stripe account, and one dashboard.

2. Add a shipping rate

Open Settings, then the Checkout tab, and create at least one active shipping rate with the countries you ship to. Stripe Checkout needs shipping options before it can start, so this step is required even while testing. A base amount of zero works for free shipping.

3. Create a product

Open Products and create the first product: name, SKU, price, and stock. Set the status to Active so the storefront can sell it. Every product and variant gets a stable public ID (wg_...): that is the reference your site will use, and it survives renames and slug changes.

4. Run a test checkout from the dashboard

On the product row, use Test checkout. Stripe Checkout opens in test mode: pay with the standard test card.

Card number  4242 4242 4242 4242
Expiry       any future date
CVC          any 3 digits

5. Check the order

The paid order appears in Orders with its line items, totals, and shipping address; stock is decremented and the order confirmation email is queued from the shared WireGum sender. The Fulfillment queue is where you will later compare carrier rates and buy labels, or record manual tracking.

6. Put it on your website

Open Storefront and authorize the domain of your site (local and staging origins such as localhost:3000 can be added too). Then add the widget script and place a product element where the page should sell:

<script
  async
  src="https://wiregum.com/api/storefront/widget"
  data-wiregum-organization="workspace-slug"
></script>

<div data-wiregum-product="wg_product_ref"></div>
<div data-wiregum-cart></div>

The static HTML/JS guide covers every data attribute and the JSON API, and there are dedicated recipes for Kirby and Astro. Build pipelines that fetch products server-side authenticate with the read-only API key from the Storefront page.

What's next

When the test loop works end to end, the going-live checklist walks through switching to real payments: Stripe onboarding, the plan gate, production domains, live shipping credentials, and a final live test.