WWooshPayment docs
Get started

Quickstart in 5 minutes

Create your first WooshPayment branded checkout, connect your store and send a test order in 5 minutes.

3 min read

Welcome to WooshPayment. In this guide we'll create your account, complete the 6-step onboarding and send a first test order.

What you need

  • 5 minutes of time
  • A Shopify or WooCommerce store with at least one published product
  • A valid email
  • A Whop account with Owner role on the Company (we'll create it in step 4)

The WooshPayment account is free. Email verification does NOT block dashboard usage: you'll get a reminder banner until you click the link, but you can onboard and receive orders right away.

1. Create the account

  1. Go to wooshpayment.com/signup
  2. Enter email, password (min 8 characters) and store name
  3. Submit → you land directly into onboarding

What happens behind the scenes:

  • We generate a unique slug from the store name (e.g. "My Brand" → my-brand)
  • We provision {slug}.wooshpayment.com on Vercel with automatic SSL
  • We send the verification email (link valid for 24h)

2. Onboarding — 6 steps

Onboarding is linear: each step must be completed to unlock the next.

Step 1 — Platform

Choose Shopify or WooCommerce.

  • Shopify → click "Connect Shopify", enter your your-store.myshopify.com, authorize the app in your Admin. On return we have accessToken + ScriptTag installed automatically.
  • WooCommerce → store URL + Consumer Key + Consumer Secret (generated in WooCommerce → Settings → Advanced → REST API).

Dedicated guides: Shopify · WooCommerce.

Step 2 — Brand

  • Logo (PNG/SVG, max 200KB, square or horizontal recommended)
  • Primary color in hex format (e.g. #0ea5e9) — applied to buttons and accents
  • Font dropdown

Live preview on the right.

Step 3 — Shipping

Define shipping tiers (e.g. Standard €4.90 3-5 days, Express €9.90 24-48h, Free over €50). They are shown to the customer at checkout.

Step 4 — Payments

Two methods available:

  • Whop Payments (required) — cards, Apple Pay, Google Pay. Activated by pasting the Whop API Key from the Integrations page (see Whop setup).
  • Cash on Delivery (COD) — optional checkbox; the customer pays the courier.

Step 5 — Preview

Open the test checkout on your subdomain {slug}.wooshpayment.com. Verify logo, colors, shipping, payment methods. You must click the link before you can proceed (anti-launch-blind).

Step 6 — Launch

WooshPayment shows you the final instruction (for Shopify the ScriptTag is already installed automatically; you don't have to paste anything into the theme). Click "Go to dashboard" → onboarding closed.

3. Connect Whop

Without Whop you can only accept COD. For cards:

  1. Create an account on whop.com as Business, verify email, create a Company
  2. In Whop → Developer → API Keys → "New key" with Owner role
  3. WooshPayment → Integrations → Whop → paste the key (format apik_…) → "Connect Whop"
  4. Response in ~1 second: "Connected" badge + visible Business ID

The role must be Owner. With Admin role the Whop /v5/company endpoint returns 401 "does not have permission to access this route".

Full guide: Whop setup.

4. Send a test order

  1. Open your store (Shopify/Woo), add a product to the cart, click "Checkout"
  2. The button is intercepted by our ScriptTag and takes you to {slug}.wooshpayment.com/checkout/{token}
  3. Complete the form (email, address, shipping)
  4. Pay with the Whop test card: 4242 4242 4242 4242, any future date, any CVV
  5. The order appears in Dashboard → Orders; you receive the notification via email to the merchant

Next steps

You're ready to sell. The "Checkout" button on your store now redirects customers to your branded checkout.

Issues?

  • Verification email not arriving → check Junk/Spam (especially Outlook/Hotmail); see Email not arriving
  • Whop returns 401 → wrong API Key role, regenerate as Owner
  • Checkout button does not redirect → see Script tag debug

For support: noreply@wooshpayment.com (we reply within 24h).