How to Configure PayPal in WHMCS

You can configure PayPal in WHMCS to accept customer payments through your WHMCS billing system. PayPal is commonly used for one-time payments, subscriptions, and recurring service payments, depending on the settings you enable in WHMCS.

This guide explains how to activate PayPal as a payment gateway, set up Instant Payment Notification, and enable PayPal for your WHMCS product groups.

• Before You Begin
• Part 1: Activate PayPal in WHMCS
• Part 2: Enable IPN in PayPal
• Part 3: Enable PayPal for Product Groups
• Testing Your PayPal Setup
• Troubleshooting PayPal in WHMCS
• Summary

Before You Begin

Before setting up PayPal in WHMCS, make sure you have:

• An active WHMCS installation
• Access to your WHMCS Admin Dashboard
• A PayPal business or merchant account
• Access to your PayPal account settings
• Products or product groups already created in WHMCS
• A secure WHMCS URL using HTTPS

If WHMCS is not installed yet, complete the WHMCS installation first before configuring payment gateways.

Part 1: Activate PayPal in WHMCS

Follow these steps to enable PayPal as a payment gateway in WHMCS.

1. Log in to your WHMCS Admin Dashboard.
2. Go to Configuration.
3. Select System Settings.
4. Click Payment Gateways.
   • In some WHMCS versions, this may appear under Setup > Payments > Payment Gateways.
5. Find the Activate Gateway dropdown.
6. Select PayPal from the list.
7. Click Activate.
8. Enter your PayPal email address.
9. Review the available PayPal settings.
10. Choose whether to allow one-time payments, subscriptions, or both.
11. Enter API details if you plan to use automatic refunds.
12. Click Save Changes.
13. Copy the IPN URL shown in WHMCS.

The IPN URL will be used in your PayPal account so PayPal can send payment updates back to WHMCS.

PayPal Subscription Options in WHMCS

WHMCS may allow you to choose how customers pay through PayPal. Review these settings carefully before saving your gateway setup.

Depending on your business needs, you may be able to:

• Allow both one-time payments and subscriptions.
• Hide the subscription button so customers only make one-time payments.
• Require subscriptions for recurring services.
• Disable one-time payments for selected billing flows.
• Enable API settings for automatic refunds.

Choose the option that best matches how you want to bill customers. For example, if you sell recurring hosting plans, PayPal subscriptions may be useful. If you prefer customers to manually pay invoices, one-time payments may be a better fit.

Part 2: Enable IPN in PayPal

Instant Payment Notification, or IPN, allows PayPal to send payment updates back to WHMCS. This helps WHMCS record payment activity, update invoices, and process payment-related events.

To enable IPN in PayPal:

1. Log in to your PayPal account.
2. Go to your account settings.
3. Open Seller Tools or the PayPal payment settings area.
4. Find Instant Payment Notifications.
5. Click Update.
6. Click Choose IPN Settings.
7. Paste the IPN URL you copied from WHMCS into the notification URL field.
8. Select Receive IPN messages or Enabled.
9. Click Save.

After IPN is enabled, PayPal can send payment notifications to your WHMCS installation.

Part 3: Enable PayPal for Product Groups

After configuring PayPal as a payment gateway, assign it to the product groups that should accept PayPal payments.

1. Return to your WHMCS Admin Dashboard.
2. Go to Configuration.
3. Select System Settings.
4. Click Products/Services.
   • In some WHMCS versions, this may appear under Setup > Products/Services.
5. Open the product group you want to update.
6. Click the Edit icon next to the product group.
7. Find the payment gateway options.
8. Check the box for PayPal.
9. Click Save Changes.
10. Repeat these steps for each product group that should accept PayPal.

If PayPal is not selected for a product group, customers may not see PayPal as a payment option during checkout for products in that group.

Testing Your PayPal Setup

After configuring PayPal, place a test order to confirm that the payment option appears correctly.

Check the following:

• PayPal appears during checkout.
• The product group allows PayPal payments.
• The PayPal email address is correct.
• The IPN URL was saved in PayPal.
• Invoices update properly after payment.
• Subscription settings match your billing preference.
• The WHMCS system URL uses the correct secure URL.

Testing the setup before accepting customer payments helps prevent checkout issues.

Troubleshooting PayPal in WHMCS

If PayPal does not appear or payments do not update correctly, review the following settings.

PayPal Does Not Show at Checkout

If PayPal is missing from checkout:

• Confirm PayPal is activated in Payment Gateways.
• Make sure PayPal is enabled for the correct product group.
• Check whether the product is assigned to the expected product group.
• Confirm the gateway is not hidden or disabled.
• Review your order form and checkout settings.

Payments Are Not Updating in WHMCS

If customers can pay through PayPal but invoices do not update:

• Confirm IPN is enabled in PayPal.
• Make sure the IPN URL from WHMCS was pasted correctly.
• Check that your WHMCS installation URL is correct.
• Confirm your WHMCS site uses HTTPS.
• Review WHMCS gateway logs for payment-related errors.

Subscriptions Are Not Working as Expected

If PayPal subscriptions are not behaving as expected:

• Review the PayPal gateway settings in WHMCS.
• Confirm whether subscriptions or one-time payments are enabled.
• Check the customer’s invoice and billing cycle.
• Make sure the product is configured for recurring billing.
• Test the order process before accepting live customer orders.

Important Notes About PayPal and WHMCS

Keep the following in mind when using PayPal with WHMCS:

• PayPal must be activated as a payment gateway in WHMCS.
• The correct PayPal email address must be entered in the gateway settings.
• IPN should be enabled so WHMCS can receive payment updates.
• Product groups must be configured to allow PayPal payments.
• API settings may be required for automatic refunds.
• A secure HTTPS URL is recommended for payment-related pages.
• PayPal account settings and available features may vary by account type or region.

Summary

You can configure PayPal in WHMCS by activating PayPal as a payment gateway, entering your PayPal email address, saving the gateway settings, copying the IPN URL, and enabling IPN in your PayPal account.

After PayPal is configured, enable it for each WHMCS product group that should accept PayPal payments. Test the checkout process before accepting live customer payments to make sure PayPal appears correctly and invoices update as expected.