Connect Whop to WooshPayment — visual 2026 guide

Whop is the payment processor WooshPayment uses to accept cards and, when account/domain/device conditions are compatible, wallets such as Apple Pay and Google Pay. The technical connection requires every step below: API key, Product ID, webhook signing secret and a real test before traffic.

Why you need a Product ID

WooshPayment creates each checkout as a "sale" of your Whop product. So you need a dedicated Whop product where all your store's sales land. The product must be:

• One-time payment, not recurring
• With no fixed pricing plan: we set the price at runtime from the customer's cart

Without a Product ID, the Whop iframe in the checkout doesn't know where to create the invoice and stalls with an error.

Prerequisites

• Whop Business account (not Personal) with a Company already created
• Administrator permissions on the Company (Owner works too)
• Verified email + basic legal data filled in (required for payouts > $500/month)

If you don't have a Whop account yet: sign up here, then come back to this guide.

1. Open the Products section in your Whop

1. Go to whop.com/dashboard and select the right Company in the top-left
2. Sidebar → Products (in the "Featured" section)

You'll see your product list (empty if it's your first). At the top right is the + Create product button.

2. Click "+ Create product" and fill in details

1. Click + Create product at the top right
2. The Add product page opens with:
   • Name (required): write something like WooshPayment Checkout — internal name, your customers don't see it
   • Title (optional): you can leave it blank
3. Pricing section below: default is "Free access" ← we change this in the next step

3. Click "Paid access"

In the Pricing section, click the Paid access card (second one, dollar icon).

Whop immediately shows a price card with default values: 29.99 USD / month, type Recurring.

4. Change the type from "Recurring" to "One-time"

1. Click the Recurring dropdown (below the price)
2. Select One-time payment
3. Verify the preview on the right now shows the "Buy now" button (no longer "Join now") — that's the signal that the type changed correctly
4. The default 29.99 USD price doesn't matter — WooshPayment overrides it with the customer's actual cart total — leave it
5. Leave the other toggles off: no "Include free trial", no "Accept payments in local currency"

Top right click Next to reach the App step (skip: WooshPayment doesn't use Whop apps) → Next again → Page step (skip) → finally Save product at the top right.

5. Copy the Product ID (prod_xxx) from the URL

After saving, Whop takes you to the page of the product you just created. Look at the browser address bar: it contains the product ID in the format prod_xxxxxxxxxxxxx.

Example URL:

https://whop.com/dashboard/biz_eKNqey9jlu9Qe0/products/prod_79AacrnFwMXjs/
                                                       ^^^^^^^^^^^^^^^^^^
                                                       this is your Product ID

Copy it — you'll need it later in WooshPayment.

6. Generate the API Key

1. Whop sidebar → Developer (bottom, above Settings)
2. You land on the Company API keys page
3. You see the list of existing keys (empty if it's your first time) + a + Create button top right

7. Click "+ Create" → role "Administrator"

1. Click the + Create button in the Company API keys section
2. The Create API key modal opens with:
   • Name: write something like WooshPayment (this is just an internal label so you remember where you used it)
   • Inherit permissions from role: dropdown defaults to Administrator
3. Leave Administrator selected, or choose Owner if you prefer
4. Do NOT tick individual permissions — inherit everything from the role
5. Click Create at the bottom right

8. Copy the API Key

After clicking Create, Whop shows you the key in format apik_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Copy it now — Whop only shows it once. If you lose it, delete and create a new one.

9. Paste the API key and Product ID into WooshPayment

Now go to the WooshPayment Dashboard:

1. Go to Dashboard → Integrations (wooshpayment.com/dashboard/integrations)
2. Scroll to the purple Whop card
3. Fill in the fields:
   • Whop API Key: paste apik_... (the key you just copied)
   • Product ID: paste prod_... (the ID from the product URL)
   • Webhook signing secret: if you already created it, paste ws_...; otherwise complete step 10 and save the secret right after
4. Click Connect Whop

Response in ~1 second:

• ✅ The API key is validated and the Business ID is saved
• ⚠️ The card still needs completion until you add the webhook signing secret from step 10
• ❌ If red: see the Troubleshooting section below

What the backend does behind the scenes:

• Tests the API key against https://api.whop.com/v5/company (6s timeout)
• Tests that prod_xxx exists and belongs to your Company (api.whop.com/api/v2/products/{prod_xxx})
• If both 200 → saves everything encrypted (AES-256-GCM): whopApiKey, whopBusinessId, whopAccessPassId, optional whopWebhookSecret, whopConnected=true
• For Apple Pay, a best-effort domain registration attempt may run, but treat Apple Pay as ready only after verifying the domain in your Whop dashboard by following Apple Pay

10. Configure the webhook (one-time, manual)

To receive payment notifications, the Whop webhook must point to us:

1. Whop Dashboard → Developer → scroll to Webhooks
2. Click + Create webhook
3. Endpoint URL: https://api.wooshpayment.com/webhooks/whop/payment-update
4. Events to check (minimum required):
   • invoice_paid
   • payment_succeeded
   • membership_activated
   • membership_went_valid
   • payment_failed
   • payment_refunded
5. Save.
6. Open the webhook you just created, copy the Signing secret (ws_...) and paste it into WooshPayment → Dashboard → Integrations → Whop → Webhook signing secret.
7. Save the secret in WooshPayment. The Whop card should turn green/ready.

If the webhook is not configured, or if the signing secret is not saved in WooshPayment, sessions may stay PENDING/in recovery and orders are not created in real time. A merchant is considered ready only when API key, Product ID and webhook secret are all present.

11. Verify the money-path

Quick end-to-end test:

1. Open your test checkout at {your-slug}.wooshpayment.com/checkout/...
2. Fill in email + address
3. If you are in production, complete a small real payment from the live cart. Use test cards only if support explicitly enabled the Whop sandbox on your merchant.
4. Click Pay
5. You should see the checkout marked COMPLETED in WooshPayment Dashboard → Orders
6. On Whop Dashboard → Payments you'll see the invoice with the right total
7. Before traffic, also verify the Shopify/Woo store order, customer/merchant emails, pixel/CAPI and return page

If you are in sandbox and the test card is declined, check that the Whop sandbox environment is actually enabled on the merchant. If you are in production, a test card does not certify the money-path: use a small real payment.

Troubleshooting

401 — does not have permission to access this route

The API key was generated with a role that is too low or custom permissions that are insufficient. Go back to step 7, recreate it with Administrator or Owner role, then replace the old key in WooshPayment.

Invalid Product ID — prod_xxx not found

The ID is from a product belonging to a different Company, or you mistyped it. Verify:

• The URL whop.com/dashboard/biz_xxx/products/prod_xxx/ should have biz_xxx equal to the Business ID shown in WooshPayment Dashboard
• No leading/trailing spaces
• The prefix is prod_, not prd_ or product_

Wrong amount charged (e.g. $29.99 instead of $50)

The Whop product was saved with Recurring type instead of One-time. Go back to the Whop product → Edit → change the dropdown to One-time → Save. No need to reconnect on WooshPayment.

Whop asks me to verify my identity

Whop blocks payouts > $500/month if you haven't uploaded:

• ID (passport or ID card)
• Address (utility bill or bank statement)
• For companies: business registration

Do not send traffic relying on payouts until the verification requested by Whop is completed or clarified in your account.

I regenerated the API Key and now everything is broken

The old one stops working immediately. Go to WooshPayment Dashboard → Integrations → Whop → Disconnect → paste the new key + same prod_xxx → Connect Whop.

Whop iframe loads empty / Apple Pay doesn't show up

Three possible causes:

1. Apple Pay: only visible on Safari with a Wallet card configured. On Chrome/Firefox/other it doesn't appear.
2. Domain not verified: your checkout subdomain ({slug}.wooshpayment.com or your custom domain) is not registered as an Apple Pay domain on your Whop. See Setup Apple Pay.
3. Webhook missing: see step 10 above. Without webhook, sessions get stuck.

Detailed fees (Whop)

Whop fees are set by Whop and can vary by country, category, risk profile, payout method and currency conversion. Check the live fee table in your Whop account before sending traffic.

WooshPayment fees depend on your active plan; Whop fees remain separate and must be checked in your Whop account.

FAQ

Can I use Stripe instead of Whop?

Not in the current public product. WooshPayment uses Whop for cards/wallets; alternatives are evaluated only as custom integrations.

Can I use an existing Whop product that already has fixed plans?

No. WooshPayment requires a dedicated product with One-time type and no plans. Create a new product just for WooshPayment following this guide.

What if I add a second Product to WooshPayment?

For now WooshPayment uses one Product ID per merchant. Multi-product is on the roadmap for merchants with multiple brands under the same Whop Company.

Does the Whop connection auto-renew? Does it expire?

The API Key doesn't expire. It stays valid until:

• You regenerate it manually
• You remove the Company role from the user that created it
• Whop revokes your account (TOS violation)

In all these cases, reconnect by following this guide.

Next steps

• Setup Apple Pay — register the checkout subdomain on your Whop
• Refund flow — how to handle refunds
• Webhook spec — payload + HMAC security