Settings reference
Every setting the module shows lives on the two gateway panels, the connection panel inside them, or a handful of WHMCS and Whop settings it depends on. This page lists all of them in one place, each with a one-line explanation and a link to the page that covers the behavior.
Payment Gateways > Whop Payments
| Setting | Options | Default | Affects | What it does | Explained in |
|---|---|---|---|---|---|
| Display Name | Free text | "Whop Payments" | Whop Payments | WHMCS's own field for the name customers see for this payment choice. The module never changes it. | Connect WHMCS to Whop |
| Show on Order Form | On, Off | WHMCS default | Whop Payments | WHMCS's own field. Controls whether customers can choose this gateway on new orders. | Paying an invoice |
| Payment environment | Sandbox, Live | Sandbox | Both gateways | Chooses which connection handles new payments, card saves and captures. Takes effect only after you press the native Save Changes. | Connect WHMCS to Whop |
| 3D Secure for payments | Always require a challenge, Require a challenge when the processor asks, Frictionless 3D Secure | Always require a challenge | Both gateways | Sets the authentication challenge requested for new-card payments. | Paying an invoice |
| 3D Secure when saving a card | Same three options | Require a challenge when the processor asks | Whop Payments only | Sets the challenge requested when a customer or admin saves a card without paying anything. | Saved cards and automatic payments |
| Enable whole-unit currencies | Yes, No | No | Both gateways | Allows new payments in nine currencies Whop only charges in whole amounts: CLP, COP, JPY, KRW, MGA, PYG, RWF, VND and XOF. | Amounts, currencies, taxes and fees |
| Informational note under 3D Secure for payments | Read-only | n/a | n/a | States that automatic renewals of a saved card are never challenged, that Sandbox cannot require a challenge and uses the conditional level instead, and that even the strictest setting does not guarantee a challenge appears. | Paying an invoice |
| Informational note under 3D Secure when saving a card | Read-only | n/a | n/a | States that a required challenge needs the cardholder present, and that even the strictest setting does not guarantee a challenge appears. | Saved cards and automatic payments |
| Informational note under Enable whole-unit currencies | Read-only | n/a | n/a | Names the nine currencies and states that a WHMCS refund for one of them must cover the full remaining balance. | Amounts, currencies, taxes and fees |
The connection panel
| Setting | Options | Default | Affects | What it does | Explained in |
|---|---|---|---|---|---|
| Paste a key, then Connect | Sandbox card or Live card | n/a | The environment you paste it into | Checks the key against the Whop business, confirms the permissions it needs, and sets up the webhook that keeps WHMCS updated. | Connect WHMCS to Whop |
| Check connection | n/a | n/a | The connected environment | Rechecks the account, the permissions and the webhook, and refreshes the status badge and the last-checked time. | Connect WHMCS to Whop |
| Replace key… | n/a | n/a | The connected environment | Opens a field for a new key belonging to the same Whop business. The old key stays active until the new one passes its checks. | Connect WHMCS to Whop |
| Status badges: Not connected, Needs attention, Ready, In use | n/a | Not connected | Each environment | Show whether a connection exists, whether it passed its last check, and which environment WHMCS currently uses for new payments. | Connect WHMCS to Whop |
| Create my Whop account (Step 1) | n/a | n/a | Live only | Sends your business details to our partner provisioning service, which creates your Whop business and asks Whop to email its owner an invitation. | Get your Live business |
| Check status (Step 1) | n/a | n/a | Live only | Asks our partner provisioning service for an update on a request that has not yet finished. | Get your Live business |
| Sign up on Whop yourself (Step 1) | n/a | n/a | Live only | Opens Whop's own sign-up page in a new tab, for creating the business without our partner provisioning service. | Get your Live business |
| I already have a Whop account (Step 1) | n/a | n/a | Live only | Skips partner provisioning and reveals the connection cards, so you can connect a business you already own. | Get your Live business |
| Try creating again (Step 1) | n/a | n/a | Live only | Appears only when no business was created yet. Submits the same request again through our partner provisioning service. | Get your Live business |
| Resend invitation / Check resend status (Step 1, under Nothing arrived?) | n/a | n/a | Live only | Asks Whop to send the ownership invitation email again, then lets you check whether that resend went out. | Get your Live business |
| Start over (Step 1) | n/a | n/a | Live only | Only available after choosing I already have a Whop account with no request ever sent. Returns Step 1 to its starting point. | Get your Live business |
| Dismiss (on a webhook repair notice) | n/a | n/a | The connected environment | Clears the notice only. It does not recheck the connection or replay any missed events. | Connect WHMCS to Whop |
Payment Gateways > Whop Checkout
| Setting | Options | Default | Affects | What it does | Explained in |
|---|---|---|---|---|---|
| Display Name | Free text | "Whop Checkout" | Whop Checkout | WHMCS's own field for the name customers see for this payment choice. | Connect WHMCS to Whop |
| Show on Order Form | On, Off | WHMCS default | Whop Checkout | WHMCS's own field. Controls whether customers can choose this gateway on new orders. | Paying an invoice |
| Show express checkout on invoices | Yes, No | No | Whop Checkout only | Adds Apple Pay or Google Pay below Pay Now on unpaid invoices, where available. | Paying an invoice |
| Local currency payments | Yes, No | No | Whop Checkout only | Enables Whop Adaptive Pricing: a local-currency quote with a choice to pay in the original currency. Whop settles and WHMCS records in the invoice currency. | Adaptive Pricing walkthrough |
| Require phone number | Yes, No | No | Whop Checkout only | Requires a country code and phone number inside the embedded checkout. An empty field prevents payment and shows “Phone number required.” | Phone number example |
| Read-only connection note | n/a | n/a | n/a | States that Whop Checkout shares the Whop Payments connection, and needs no separate setup once Whop Payments shows Ready. | Connect WHMCS to Whop |
WHMCS settings the module relies on
| Setting | Options | Default | Affects | What it does | Explained in |
|---|---|---|---|---|---|
| System URL | Public HTTPS URL | Your installation's value | Both gateways | Used to build the callback address Whop sends events to. Change it, then run Check connection. | Connect WHMCS to Whop |
| System cron | Scheduled task | WHMCS's normal setup | Both gateways | Should run every five minutes. It finishes work that could not complete right away and retries anything that needs another attempt. | Troubleshooting and support |
Notification rule for whop.dispute.created | Notification rule | No rule exists | Both gateways | Delivers a staff alert when a bank or card dispute opens. | Disputes and staff alerts |
Notification rule for whop.resolution_center_case.created | Notification rule | No rule exists | Both gateways | Delivers a staff alert when a customer opens a Whop Resolution Center case. | Disputes and staff alerts |
Notification rule for whop.refund.failed | Notification rule | No rule exists | Both gateways | Delivers a staff alert when a refund WHMCS already recorded later fails at Whop. | Disputes and staff alerts |
| View Gateway Balances admin permission | Granted, not granted | Set per admin role | Whop Payments only | Without it, an administrator cannot see the Whop Balance widget or the Whop balances on Billing > Transactions. | Balances, payouts and transactions |
| Module Debug Logging | On, Off | Off | Both gateways | While on, stores sanitized details of each Whop request in Utilities > Logs > Module Log. Turn it on briefly to reproduce a problem, then off again. | Troubleshooting and support |
| Automation Settings (credit card processing days, retry schedule) | Native WHMCS settings | WHMCS default | Whop Payments saved cards | Decides when a renewal invoice is generated and when WHMCS attempts or retries automatic collection. | Saved cards and automatic payments |
Whop dashboard settings that matter
| Setting | Options | Default | Affects | What it does | Explained in |
|---|---|---|---|---|---|
| Payment orchestration (Whop, Settings > Checkout) | On, Off | Set by Whop for a new business | Both gateways | Routes each payment to whichever processor behind Whop is most likely to accept it, for the fee Whop shows beside the setting. The setup guides turn it on. | Get your Live business |
| Statement descriptor (Whop, Settings > Checkout) | Free text | Whop's own default | Both gateways | Sets what appears on the customer's card statement for a Whop payment. | Get your Live business |
| Send transactional emails to your members (Whop, Settings > Checkout) | On, Off | On for a new business | Both gateways | Sends Whop's own emails to your customers. Turn it off so WHMCS stays the only sender. | Get your Live business |
| Tax handling (Whop, Settings > Tax) | "I'll handle tax myself", "Whop collects tax, I remit", Whop calculates and remits | Not set until you choose | Both gateways | Must be set to "I'll handle tax myself" so WHMCS calculates your tax, not Whop. The connection check confirms this choice. | Get your Live business |
| Tax type (Whop, Settings > Tax) | Inclusive, Exclusive | Review the account | Both gateways | Set Inclusive to preserve the issued WHMCS amount. | Get your Live business |
| Collect VAT IDs from users (Whop, Settings > Tax) | On, Off | Review the account | Both gateways | Turn off; manage invoice tax details in WHMCS. | Get your Live business |
| Payment methods (Whop, Settings > Checkout > Payment methods) | Per-method toggles, or "Include default payment methods" | Include defaults on | Whop Checkout mainly | Chooses which payment methods Whop may offer at checkout. Card must stay enabled, since both gateways depend on it. | Get your Live business |
| PayPal (Whop, Settings > Payments) | Set up, or not | Not set up | Whop Checkout | Must be completed in Whop before PayPal can appear as a payment choice. It does not import old WHMCS PayPal subscriptions. | Get your Live business |
| Apple Pay and Google Pay for embedded checkout (Whop, Settings > Checkout) | Domain verification | No domain registered | Whop Checkout | Register your WHMCS domain for embedded wallet checkout. | Get your Live business |
| Refund policy and automatic refund thresholds (Whop, Settings > Payments) | A USD threshold per funding type, or disabled | Set by Whop for a new business | Both gateways | Lets Whop refund a dispute or Resolution Center case automatically, under a threshold, before any WHMCS staff member acts. | Get your Live business |
| Checkout limit review (Whop, Settings > Payments) | Request a review | Account-specific | Both gateways | Check the current checkout limit and request a review if your invoices exceed it. Sandbox and Live limits can differ. | Get your Live business |
Related: Connect WHMCS to Whop, The two gateways side by side.
Updated 16 days ago
Did this page help you?