1. Overview & Requirements

The Whop Payment Gateway for WooCommerce connects your WordPress e-commerce storefront directly to the Whop Portal ecosystem. Instead of manually registering individual payment IDs for every variant, product price, or discount on two systems, this plugin communicates dynamically with the Whop API to generate secure checkout redirect sessions on-the-fly matching cart totals.

Minimum System Requirements

Before installing the gateway, ensure your server environment meets the following specifications:

• WordPress Version 5.6 or higher
• WooCommerce Version 5.0 or higher
• PHP Version 7.4, 8.0, 8.1, or 8.2
• Active SSL Certificate (HTTPS mandatory for secure webhook deliveries)
• A verified Seller profile registered on Whop.com

2. Installation Guide

Follow these steps to upload, install, and authorize your WooCommerce integration:

1. Download ZIP Package: Log in to your billing account and download the gateway ZIP file.
2. Upload Plugin: In WordPress dashboard, go to Plugins > Add New. Click Upload Plugin, select the ZIP file, and click Install Now.
3. Activate Plugin: Once installed, click Activate Plugin.
4. Validate License: You will be prompted to enter your license key to enable automatic background updates. Paste your license key from your Freemius buyer dashboard and authorize connection.

3. Whop Developer Portal Setup

To authorize transactions, you must link the plugin to your business profile on the Whop Developer Hub. This allows the plugin to establish checkout sessions via secure API protocols.

Retrieving API Credentials

1. Go to the Whop Developer Applications tab and log in.
2. Click Create New Application and enter details representing your WooCommerce store.
3. Locate your unique API Token and Client Secret. Keep these keys confidential.

4. WooCommerce Gateway Setup

With your API credentials ready, configure your WooCommerce settings to activate the checkout redirect flow:

1. Go to WooCommerce > Settings > Payments in your WordPress backend.
2. Locate Whop Gateway in the list of payment methods and click Manage.
3. Check the box to Enable Whop Payments.
4. Paste your API Token and Client Secret into the respective fields.
5. Configure parameters:
   • Multi-Currency Sync: Automatically detects and transmits the active cart's currency (e.g., USD, EUR, GBP) to Whop's hosted checkout to guarantee correct transaction units.
   • Sandbox Testing Toggle: Turn on during staging to check checkout flows without processing charges.
6. Click Save Changes.

5. Mapping Product Access

Our gateway creates payment sessions dynamically. When mapping WooCommerce inventory to Whop membership tiers or Discord roles:

• Create Product: Setup a standard Simple Product in WooCommerce.
• Link Access: Under the Whop settings box on the product editing page, choose the target Whop membership tier from the dropdown options.
• Checkout Flow: When checkout triggers, our plugin generates the session, links the user\'s profile, and redirects them to the Whop payment page.

6. Webhook Signatures Setup

Webhooks verify payment statuses asynchronously and complete your orders. In your Whop Developer Dashboard, add a new webhook pointing to the URL displayed in the plugin settings screen. Subscribe to membership.went_active and membership.went_inactive events.

Below is a PHP snippet showing how the plugin validates webhook payload headers:

$headerSignature = $_SERVER['HTTP_X_WHOP_SIGNATURE'];
$calculated = hash_hmac('sha256', $payloadJson, $clientSecret);

if (hash_equals($calculated, $headerSignature)) {
    // Process order update
} else {
    // Reject invalid request
}
                

7. Troubleshooting Guide

If you encounter configuration conflicts, consult this checklist:

8. Technical Support Form

Need custom setup assistance? Submit a ticket to our support team using the form below. Tickets are monitored 24/7. Fields are checked against Google reCAPTCHA to prevent spam bots.