Migrate to PayPal Checkout

In WHMCS 8.9 and later, we recommend PayPal Payments as our preferred PayPal integration.

If you use PayPal Basic automated recurring PayPal subscriptions, you can migrate to PayPal Checkout module. If you have not used the previous module, you do not need to perform these migration steps and can go immediately to PayPal Checkout.

Migrate to PayPal Checkout

To do this:

1. Activate PayPal Checkout.

To activate the PayPal Checkout module, find the PayPal Checkout module in the list of available payment gateways and activate it.

For steps to activate and configure a payment gateway, see Configure a Payment Gateway.

2. Hide the previous module.

PayPal Checkout is not a direct replacement for the PayPal Basic module.

If you set up PayPal subscriptions via PayPal Basic or a custom or third-party PayPal integration, do not deactivate the PayPal Basic module. You must keep your previous module active for WHMCS to continue recognizing and applying recurring payments.

To do this for PayPal Basic:

  1. Go to Configuration () > System Settings > Payment Gateways.
  2. Find PayPal Basic.
  3. Uncheck Show on Order Form:
    Configuring PayPal Basic in Payment Gateways
  4. Click Save Changes.

This will stop PayPal Basic from showing in the list of available payment methods during checkout and in the Payment Method menu on invoices (if you have enabled it).

If you used a different PayPal module, use the above steps for that module.

3. Migrate the existing services.

To allow existing services to use PayPal Checkout’s features, change their default payment method to the PayPal Checkout module.

To do this, update the individual services in your WHMCS installation. You can run the following queries against your WHMCS database to update all services:

UPDATE tblhosting SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';
UPDATE tblhostingaddons SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';
UPDATE tbldomains SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';
UPDATE tblinvoices SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal' AND status IN ('Draft','Unpaid');

This will update all services, service addons, domains, and Draft or Unpaid invoices to use PayPal Checkout.

PayPal Basic will remain active to receive and handle IPN notification of payments appropriately.

payment-gateways paypal

Last modified: June 14, 2024