Documentation

Get from installation to checkout with the right mental model.

The plugin preserves WooCommerce as the store source of truth. These guides explain the flow without requiring you to expose credentials or rewrite your checkout.

01

Getting Started

Confirm that WooCommerce is active, your store currency and shipping rules are configured, and your own Whop business is ready.

  • Keep products, prices, taxes and shipping in WooCommerce.
  • Use the existing plugin settings for your Whop business configuration.
02

Installation

Install the supplied plugin package in WordPress, activate it once, then verify that WooCommerce can calculate a cart before testing payment selection.

  • Use Plugins → Add New → Upload Plugin.
  • Do not keep duplicate active copies of the plugin.
03

Connect Whop

Enter only your own Whop business credentials in the existing plugin settings. Credentials are server-side configuration and must never be shared in a support message.

  • Confirm the business and plan mapping before launch.
  • Keep API keys and webhook secrets out of browser code.
04

WooCommerce Checkout

WooCommerce remains the source of truth for products, variations, quantities, coupons, shipping, tax, customer fields and order records.

  • Test both Add to Cart and Buy Now separately.
  • Review the final WooCommerce total before placing an unpaid test order.
05

Card Payments

Card eligibility is determined by the merchant’s Whop configuration. The payment surface opens only after the protected WooCommerce order-pay step.

  • Do not record card details in WordPress.
  • Do not mark an order paid until a verified webhook is processed.
06

Bank Transfer

Bank Transfer remains subject to provider and merchant eligibility. The WooCommerce order stays pending until the payment lifecycle is verified.

  • Keep the pending order intact while the customer completes the provider flow.
  • Do not manually complete an unpaid order.
07

Webhooks

A signed webhook is the fulfillment authority. It reconciles the payment result and protects against duplicate processing.

  • Keep the existing webhook URL and secret stable.
  • Treat duplicate delivery as expected and idempotent.
08

Licensing and Updates

A verified purchase creates an ACTIVE core license. Updates and support are separate annual entitlements; their expiry never disables an installed active core.

  • Starter allows one site, Professional five, and Agency is semantic unlimited.
  • Use secure dashboard delivery for published releases only.
09

Troubleshooting

Start with gateway eligibility, WooCommerce order status, configured business context and the current checkout total. Never send credentials to support.

  • Capture a safe error class or order reference, not an API key.
  • Use the customer portal for account-specific support.
Security note: never place API keys or webhook secrets in client-side code, a public repository or support ticket. The plugin reads its sensitive configuration server-side from WordPress settings.