WWooshPayment docs
Get started

Guided quickstart

Create your first WooshPayment branded checkout, connect your store and send a pilot order before traffic.

4 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

  • A Shopify or WooCommerce store with at least one published product
  • A valid email
  • A Whop account if you want to accept cards or eligible wallets; if you start with Cash on Delivery only, you can connect Whop later

Demo setup does not require an active live plan. After signup you land on the email verification screen (/verify-email-pending): click the email link before starting onboarding. If the email does not arrive, use "Resend verification email" and check Spam/Promotions.

1. Create the account

  1. Go to wooshpayment.com/signup
  2. Enter email, password (min 8 characters) and store name
  3. Submit → check your inbox and click the verification link
  4. After verification you enter onboarding

If public access is closed, use the invite link received from the WooshPayment team: the token is also verified by the backend during registration.

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 → create a dev app in your Shopify Dev Dashboard, paste domain your-store.myshopify.com, Client ID and Client Secret, then authorize the app in your Admin. On return we have accessToken + ScriptTag installed, then it must be verified with a real cart test on the live theme.
  • WooCommerce → install the official plugin, then paste store URL + Consumer Key + Consumer Secret (generated in WooCommerce → Settings → Advanced → REST API).

Dedicated guides: Shopify · WooCommerce.

Step 2 — Brand

  • Public logo URL, if you want to show the logo in checkout
  • Primary color and secondary/accent color in hex format (e.g. #0ea5e9) — applied to buttons and accents
  • Checkout language: automatic from browser or forced
  • Trust badges, banner and reviews to show in checkout

Live preview on the right.

Step 3 — Shipping

Define shipping tiers in base EUR (e.g. Standard €4.90 3-5 days, Express €9.90 24-48h, Free over €50). If checkout runs in a non-EUR market, rates and thresholds are converted automatically into the customer's checkout currency.

Step 4 — Payments

Two methods available:

  • Whop Payments — required if you want to accept cards or eligible wallets. Wallets appear only when Whop, your checkout domain, browser and device support them. Whop is ready only after API key, Product ID and webhook secret are saved 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 — Final check

WooshPayment shows the final check: for Shopify the ScriptTag must be installed and verified with a real click from the live cart; for WooCommerce the plugin must be active and must have intercepted at least one checkout. After the active plan, you can mark the setup verified and go to the dashboard.

3. Connect Whop

You can skip this step if you start with Cash on Delivery only. Connect Whop before enabling cards or wallets:

  1. Create an account on whop.com as Business, verify email, create a Company
  2. In Whop → Developer → API Keys → "New key" with Administrator or Owner role
  3. WooshPayment → Integrations → Whop → paste API key (apik_…), Product ID (prod_…) and webhook secret (ws_…)
  4. The dashboard shows green state if Whop is ready, amber state if Product ID or webhook secret is missing

The key must inherit a sufficient Company role. If Whop's /v5/company endpoint returns 401 "does not have permission to access this route", recreate the key as Administrator or Owner.

Guided setup: Connect Whop. Full guide with Product ID: 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 the Shopify ScriptTag or the WooCommerce plugin and takes you to {slug}.wooshpayment.com/checkout/{token}
  3. Complete the form (email, address, shipping)
  4. If Whop is ready in production, run a small real payment from the live cart. Use a test card only if support explicitly enabled the Whop sandbox on your merchant. If you are testing COD, choose Cash on Delivery and complete the order without card payment.
  5. The order appears in Dashboard → Orders; you receive the notification via email to the merchant

Next steps

You're ready for traffic only after the pilot order: the "Checkout" button must redirect to the branded checkout, the order must appear in the store, and you must verify emails, pixel/CAPI and the order dashboard.

Issues?

  • Verification email not arriving → check Junk/Spam (especially Outlook/Hotmail); see Email not arriving
  • Whop returns 401 → API Key role too low, regenerate as Administrator or Owner
  • Checkout button does not redirect → for Shopify see Script tag debug; for WooCommerce verify the official plugin and REST API

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