Connect Whop to WooshPayment — visual guide 2026

Whop is the processor WooshPayment uses to accept cards, Apple Pay and Google Pay on your branded checkout. To connect it, you just need an API key generated from Whop's Dev Dashboard and pasted into WooshPayment.

Time required: 5 minutes. No Apple Developer Account, no document verification until you exceed $500/month in payouts.

Prerequisites

• A Business Whop account with at least one Company created (sign up at whop.com/signup)
• Administrator permissions on the Company (Owner is even better)
• A Whop Product of type One-time payment — see the full Whop setup if you need to create it

In WooshPayment, you just need to have completed the "Platform" step of onboarding (Shopify or WooCommerce connected).

1. Open the Whop Dashboard on the right Company

1. Go to whop.com/dashboard
2. Top-left, pick the right Company from the dropdown (e.g. Elvyora)
3. You'll land on the Home dashboard
4. In the bottom-left of the sidebar, click Developer (icon </>)

2. Open "Company API keys" and click "+ Create"

1. The Company API keys tab is already active
2. You'll see existing keys (empty if it's your first time)
3. Top-right, click + Create

3. Fill in the "Create API key" modal

1. Name: type something recognizable, e.g. WooshPayment or my-store
   • It's just an internal label on your Whop Company — your customers never see it
2. Inherit permissions from role: leave it on Administrator (default)
   • The Administrator role covers everything WooshPayment needs to process payments and read orders
3. DON'T tick individual permissions in the list — the key already inherits everything from the role
4. Click Create in the bottom-right

4. Key created — click the eye to reveal

Whop opens the API key details modal. The key is shown masked (e.g. apik_JwX9••••bcc3) — that's a security default, but we need the full key.

1. Click the eye icon 👁 to reveal the full key

5. Copy the full key

Now the key is shown in cleartext (apik_JwX9vv89apgDP_…). Click the Copy icon 📋 on the right.

6. Paste into WooshPayment → Integrations

Now jump back to WooshPayment:

1. Go to Dashboard → Integrations (wooshpayment.com/dashboard/integrations)
2. Find the Whop card in the "Main integration" section
3. Paste the key (apik_…) in the API Key input
4. Also fill in the Product ID if required (see full Whop setup for how to grab prod_xxx from the product URL)
5. Click Connect Whop

Response in ~1 second:

• ✅ Green "Whop account linked!" + ✓ Connected badge + visible Business ID (e.g. biz_eKNqey9jlu9Qe0)
• ❌ Red: see Troubleshooting

What the backend does behind the scenes

• Tests the key against https://api.whop.com/v5/company (6s timeout)
• Retrieves the businessId (biz_xxx) and stores it in the DB
• Saves everything encrypted AES-256-GCM (whopApiKey, whopBusinessId, whopConnected=true)
• Fire-and-forget: registers your checkout domain as an Apple Pay domain on your Whop (see Apple Pay)

Troubleshooting

401 — does not have permission to access this route

The key was generated with too low a role. Go back to step 3, delete the current key, and create a new one with role Administrator (or Owner).

Invalid API key

• The key was copied wrong — check there are no spaces before/after
• The key starts with apik_ (not whk_ which is the webhook secret)
• The Company that generated the key is still active (Whop hasn't suspended it)

Invalid Product ID

You entered a prod_xxx from a different Company. The biz_xxx in the product URL must match the Business ID shown in WooshPayment after connect.

Product price overrides the cart total

The Whop product was saved with a fixed recurring plan instead of One-time payment. WooshPayment can't override the price if the product has a fixed plan. Fix: go back to the Whop product → Edit → change the type to One-time → Save. No need to reconnect on WooshPayment.

I rotated the key and now nothing works

The old key stops working the moment you rotate. Go to Dashboard → Integrations → Whop → Disconnect → paste the new key → Connect Whop.

⚠️ REQUIRED step: the webhook signing secret (ws_)

Skip this and customers pay but orders never show up in Shopify (or in your dashboard). It's the #1 thing to get right.

Why it's needed: when a customer pays, Whop sends WooshPayment a signed notification using a secret from your account. WooshPayment verifies that signature before creating the order. Without the secret, the notification is rejected and the order isn't created in real time.

How to get it (1 minute):

1. Go to Whop → Developer → Webhooks: dash.whop.com/settings/developer/webhooks
2. Find (or create) the endpoint pointing at https://api.wooshpayment.com/webhooks/whop/payment-update
3. Make sure at least payment.succeeded and membership.went_valid (or membership.activated) events are enabled
4. Copy the Signing secret — it starts with ws_
5. Paste it into WooshPayment → Dashboard → Integrations → Whop, in the Webhook signing secret field, and save

Done: from then on your orders appear in Shopify instantly.

Connected before this update? You'll see a yellow "Add your webhook secret" box in Dashboard → Integrations → Whop. Meanwhile WooshPayment still auto-recovers orders every couple of minutes, but with the secret they become instant.

FAQ

Can I use the same key for multiple stores?

Technically yes, but not recommended. Create a separate key for each WooshPayment store — that way if you want to disconnect one store, you can revoke just its key without touching the others.

Does the key expire?

No, it doesn't expire. It stays valid as long as:

• You don't manually delete it from Whop → Developer
• You don't remove the role from the user who created it
• Whop doesn't suspend your account for TOS violation

What's the difference between Administrator and Owner?

For WooshPayment, both work. The difference matters when you want to change billing settings, payouts, or Company members — those stay reserved for the Owner. For processing payments, Administrator is enough.

Next steps

• Full Whop setup (with Product creation) — if you still need to create the product
• Apple Pay — register your checkout subdomain on your Whop
• Webhook spec — payload + HMAC security
• Onboarding wizard — coming back after connect and not sure what to do? pick up here