PayPal Checkout gives your customers a simplified and secure checkout experience. It presents the most relevant payment types with methods like Pay with Venmo, PayPal Credit, credit card payments, iDEAL, Bancontact, Sofort, and other payment types.

Supported Features #

Type: Third-Party

Adding the PayPal Payment Gateway #

To set up the PayPal payment gateway in WHMCS:

1. Ensure that your WHMCS installation uses an HTTPS-secured connection with a valid SSL certificate. If it does not, this module will not function correctly.
2. Go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
3. Click Activate & Configure for PayPal.
4. Log in to your existing PayPal account or sign up for a new one.
5. Confirm permission for the WHMCS application to access your account.
6. Click Confirm to continue. API credentials will populate and WHMCS will save them automatically. The page will refresh.
7. Check Show on Order Form to display this payment method in the Client Area during checkout.
8. Click Save Changes.

Limitations and Restrictions #

The following limitations and restrictions apply to PayPal Checkout:

• Users who choose to use one of the PayPal Checkout express checkout options in the view cart step of the shopping cart workflow will not select a payment gateway in the checkout step.
• The option to apply credit during checkout for existing customers who have a credit balance does not display during express checkout to avoid conflicts with the pre-authorized amount at PayPal.
• MarketConnect promotions will not display after payment is pre-authorized with PayPal to avoid changes being made to the cart total after authorization.
• Convert to for Processing is not available for this module. Payments will process in the client’s selected currency.
• The system will offer clients the subscription option if they are ordering a recurring product on a monthly or annual billing cycle. The module configuration does not offer an option to force only one-time payments.

Unlinking Your PayPal Account #

Clicking Unlink PayPal Account will irreversibly remove the link to your PayPal account. WHMCS will stop recording subscription payments.

Checkout #

With PayPal Checkout, users can choose to check out using PayPal.

Checkout with PayPal #

Clicking Checkout with PayPal will open a payment authorization process. Users will log in to their PayPal accounts and confirm their payment before returning to WHMCS to complete the checkout process.

• When first-time customers return to WHMCS, the registration form will pre-fill the name, email, and billing address.
• Existing users who have not already authenticated will see the login page with their email address pre-filled.

The View Cart step of the order process will display the PayPal Checkout options:

This displays in addition to the default checkout options.

Express Checkout #

Express checkout users will not see a payment method choice after authorizing payment by PayPal. Instead, they will see a message indicating that they have pre-approved payment.

• Carts that only have One-Time, Biennial, or Triennial payment items will immediately include Express Checkout options.
• For carts that contain at least one recurring item (on a Monthly or Annual billing cycle), the client can proceed through the standard WHMCS checkout process and select PayPal as the payment method. After placing an order, the system will redirect them to PayPal to create a subscription.

Disputes #

In WHMCS 8.3 and higher, you can manage disputes for this module from within WHMCS at Billing > Disputes.

Troubleshooting #

You can find information about most payment gateway-related errors in the logs at Billing > Gateway Log and in the Module Log.

You may encounter the following common issues when using PayPal payment gateways:

Last modified: 2025 February 6