Whop Elements: what they are and how to use them on WooCommerce
Whop Elements are Whop's embeddable UI components: Checkout, Payment, Express Checkout and more. Which one fits a store, and how WooCommerce uses them.
On this page
Whop Elements are Whop’s embeddable UI components: drop-in pieces of Whop (checkout, payment fields, wallets, payouts, KYC, chat) that run on your own page. For a store, two families matter: the Checkout element, which embeds Whop’s full checkout, and the payment elements, which only collect a payment method so your server can charge it. WhopForWoo uses the Checkout element inside the WooCommerce checkout.
The Whop Elements a store can use
| Element | What it does | Server code needed to charge |
|---|---|---|
| CheckoutElement | Whop’s whole checkout in one component: email, payment method, pay button | No (fulfil from the webhook) |
| PaymentElement (+ EmailElement, AddressElement) | Collects the payment method in PCI-isolated fields and returns a ctok_ confirmation token |
Yes: Payments API call with the token |
| ExpressCheckoutElement | One-press Apple Pay and Google Pay buttons, for a product page | No (fulfil from the webhook) |
| Card fields (number, expiry, CVC) | Separate card inputs for a fully custom layout | Yes |
Whop’s catalogue also includes elements for KYC and verification, balances and withdrawals, reports, ads and chat. Those are for building on top of Whop, not for taking a payment.
Checkout element vs payment elements
Checkout element. You mount it with a plan; it opens the session, prices the order, offers the methods allowed for that buyer, and completes the payment. You pass metadata (your order ID) and a returnUrl. Fulfilment comes from the payment.succeeded webhook.
Payment elements. You build the form layout. On submit, createConfirmationToken turns what the elements collected into a single-use token. Your server sends it to the Payments API with the variant or an inline amount, gets back a client_secret, and the browser calls handleNextAction for 3D Secure or a bank redirect if needed. More control, more code.
For a WooCommerce store, the Checkout element is the shorter path: WooCommerce already owns the layout around it, and Whop handles the payment step end to end.
How WhopForWoo uses Whop Elements
- Loads the Whop Elements script from
cdn.whop.comon the checkout and order-pay pages. - Creates a checkout configuration for the WooCommerce order (exact total, order ID and site in metadata).
- Mounts the Checkout element in the payment box with your appearance settings (theme, button colour, background colour, corner radius, language) and hides Whop’s summary header.
- Enables Apple Pay and Google Pay on the configuration.
- Confirms the payment server-side, from Whop’s API and the signed webhook, before the order is marked paid.
The element’s locales supported by the plugin: English, Spanish, Chinese, Dutch, Portuguese, German, Hungarian, Italian, French, Japanese, Polish, Turkish.
Using Whop Elements without WooCommerce
Any site that can load a script can mount the Checkout element. Whop documents React (@whop/elements-react) and plain JavaScript. You still need an https return page and a server that verifies the webhook signature before granting access or shipping anything. Whop’s own guide warns that the return URL alone proves nothing, since anyone can type status=succeeded.
If your products live in WooCommerce, the embedded checkout page shows what the plugin takes care of.
Frequently asked questions
What are Whop Elements?
Whop's library of embeddable UI components, loaded by script or through the @whop/elements packages. They cover checkout and payments, but also payouts, KYC, reporting and chat.
What is the difference between the Checkout element and payment elements?
The Checkout element is Whop's whole checkout in one component and needs no server code to charge. Payment elements only collect the payment method and return a confirmation token that your server charges through the Payments API.
Do Whop Elements support Apple Pay and Google Pay?
Yes. The Express Checkout element shows one-press Apple Pay and Google Pay buttons, and wallets can also be offered inside the checkout form.
Which Whop Element does WhopForWoo use?
The Checkout element, mounted in the WooCommerce payment box with a checkout configuration created for each order.