PayPal Checkout Migration Guide - Revision history

SarahK at 16:06, 7 September 2022

2022-09-07T16:06:41Z

SarahK at 20:24, 27 April 2022

2022-04-27T20:24:57Z

SarahK: /* Step 2: Hide the PayPal Basic module */

2022-04-27T20:07:21Z

‎Step 2: Hide the PayPal Basic module

John at 14:27, 29 June 2021

2021-06-29T14:27:59Z

John: /* Step 4: Turn Off IPNs */

2021-03-19T10:39:28Z

‎Step 4: Turn Off IPNs

John at 10:32, 19 March 2021

2021-03-19T10:32:48Z

SarahK at 12:59, 5 August 2020

2020-08-05T12:59:43Z

John: /* Step 2: Deactivate the PayPal Basic module */

2020-02-19T15:44:53Z

‎Step 2: Deactivate the PayPal Basic module

Matt: /* Step 3: Migrating existing products/services */

2020-02-19T13:54:16Z

‎Step 3: Migrating existing products/services

Matt: /* Step 3: Migrating existing products/services */

2020-02-19T13:43:13Z

‎Step 3: Migrating existing products/services

@@ Line 5: / Line 5: @@
 To learn more about PayPal Checkout and the integration features, see [[PayPal Checkout]].
-==Step 1: Activate the new PayPal Checkout module==
+==Step 1: Activate the PayPal Checkout module==
-−
-To activate the new PayPal Checkout module:
+To activate the PayPal Checkout module:
-−
-# Find the '''PayPal Checkout''' module at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payment Gateways'''.
+# Find the '''PayPal Checkout''' module in the list of available payment gateways:
-# Click '''Activate & Configure''' under the PayPal banner.
+#* In WHMCS 8.6 and later, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''.
 # Follow the instructions to sign in to your PayPal account in order to link it with your WHMCS installation.

@@ Line 1: / Line 1: @@
-PayPal Checkout is the latest and recommended PayPal integration to use for anybody wanting to accept payments by PayPal.
+PayPal Checkout is the latest and recommended PayPal integration to use for accepting payments by PayPal.
-To learn more about PayPal Checkout and the integration features, please see the [[PayPal Checkout]] documentation.
+If you have used the previous PayPal module for automated recurring PayPal subscriptions, we recommend migrating to the newer 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 the new PayPal Checkout module.
-==Who this guide applies to==
+To learn more about PayPal Checkout and the integration features, see [[PayPal Checkout]].
-The following guide applies to users of WHMCS who have used the previous PayPal module in WHMCS for automated recurring PayPal subscriptions.
+==Step 1: Activate the new PayPal Checkout module==
-It contains important information about how you can migrate to the newer PayPal Checkout module.
+To activate the new PayPal Checkout module:
-If you are new to WHMCS, or have not used the PayPal Subscription functionality available in prior PayPal integrations, then this guide does not apply to you. You may activate the new "PayPal Checkout" module and/or deactivate the prior "PayPal Basic" module without issue.
+# Find the '''PayPal Checkout''' module at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payment Gateways'''.
-== Migration Guide==
+==Step 2: Hide the PayPal Basic module==
-===Step 1: Activate the new PayPal Checkout module===
+The PayPal Checkout module is not a direct replacement for the previous PayPal module.
-Begin by activating the new PayPal Checkout integration.
+If you set up PayPal subscriptions via the previous PayPal integration ('''[[PayPal Basic]]''') or via a custom or third-party PayPal integration, '''do not deactivate''' the '''PayPal Basic''' module. The '''PayPal Basic''' module must be kept active for WHMCS to continue recognizing and applying recurring payments.[[File:Paypal_hide_order_form.png|thumb|Uncheck Show on Order Form]]
 # Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payment Gateways'''.
-# Locate the PayPal Basic module.
+# Locate the '''PayPal Basic''' module.
-# Uncheck the "Show on Order Form" checkbox.
+# Uncheck the '''Show on Order Form''' checkbox.
-# Click Save Changes.
+# Click '''Save Changes'''.
-This will stop the PayPal Basic module from showing in the list of available payment methods both during checkout as well as via the Payment Method selection dropdown on invoices (if enabled).
+This will stop the '''PayPal Basic''' module from showing in the list of available payment methods both during checkout as well as via the '''Payment Method''' selection menu on invoices (if you have enabled it).
-===Step 3: Migrating existing products/services===
+==Step 3: Migrating existing products/services==
-In order to have existing products/services benefit from the new features and functionality of the PayPal Checkout module, it is necessary to change their default payment method to the new module.
+In order to have existing products and services benefit from the new features and functionality of the '''PayPal Checkout''' module, it is necessary to change their default payment method to the new module.
 This can be done on an individual basis, or can be done in bulk by executing the following queries against your WHMCS database:
@@ Line 47: / Line 38: @@
 </div>
-This will update all products, services, addons, domains and draft/unpaid invoices to use the new PayPal Checkout integration to allow users to benefit from the optimised checkout workflow and subscription information procedure.
+This will update all products, services, addons, domains, and draft or unpaid invoices to use the new '''PayPal Checkout''' integration.
-The PayPal Basic module will remain active to be able to continue to receive and handle IPN notification of payments appropriately.
+The PayPal Basic module will remain active to receive and handle IPN notification of payments appropriately.

@@ Line 27: / Line 27: @@
 If you have PayPal Subscriptions that were setup either via the previous official PayPal integration from WHMCS (now known as "PayPal Basic"), or via a custom or 3rd party PayPal integration that were later migrated to WHMCS, it is important that you '''do not deactivate''' the "PayPal Basic" module. The PayPal Basic module must be kept active in order for recurring payments made via these subscriptions to continue to be recognised and applied automatically.
 [[File:Paypal_hide_order_form.png|thumb|Uncheck Show on Order Form]]
-# Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Payment Gateways''' or, prior to WHMCS 8.0, '''Setup > Payment Gateways'''.
+# Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payment Gateways'''.
 # Locate the PayPal Basic module.
 # Uncheck the "Show on Order Form" checkbox.

← Older revision		Revision as of 14:27, 29 June 2021
Line 50:		Line 50:

	The PayPal Basic module will remain active to be able to continue to receive and handle IPN notification of payments appropriately.		The PayPal Basic module will remain active to be able to continue to receive and handle IPN notification of payments appropriately.
−
−	~~===Step 4: Turn Off IPNs===~~
−	~~[[File:disable_ipn.png\|thumb\|Disable PayPal IPNs]]~~
−	~~To prevent payments made via the new integration method being sent via the legacy IPN system, IPNs should be turned off in your PayPal account settings:~~
−	~~# Navigate to '''Account Settings > Website payments > Instant Payment Notifications '''~~
−	~~# Click the '''Choose IPN Settings''' button~~
−	~~# Select the '''Disabled''' option~~
−	~~# Click '''Save'''~~
−	~~Payments and subscriptions made via the PayPal Basic module will continue to be recorded in WHMCS even with IPNs disabled at the account level.~~

@@ Line 52: / Line 52: @@
 ===Step 4: Turn Off IPNs===
 To prevent payments made via the new integration method being sent via the legacy IPN system, IPNs should be turned off in your PayPal account settings:
-# Navigate to '''Profile > Profile and Settings > My Selling Tools > Instant Payment Notifications '''
+# Navigate to '''Account Settings > Website payments > Instant Payment Notifications '''
 # Click the '''Choose IPN Settings''' button
 # Select the '''Disabled''' option
 # Click '''Save'''
 Payments and subscriptions made via the PayPal Basic module will continue to be recorded in WHMCS even with IPNs disabled at the account level.

← Older revision		Revision as of 10:32, 19 March 2021
Line 50:		Line 50:

	The PayPal Basic module will remain active to be able to continue to receive and handle IPN notification of payments appropriately.		The PayPal Basic module will remain active to be able to continue to receive and handle IPN notification of payments appropriately.
		+
		+	===Step 4: Turn Off IPNs===
		+	To prevent payments made via the new integration method being sent via the legacy IPN system, IPNs should be turned off in your PayPal account settings:
		+	# Navigate to '''Profile > Profile and Settings > My Selling Tools > Instant Payment Notifications '''
		+	# Click the '''Choose IPN Settings''' button
		+	# Select the '''Disabled''' option
		+	# Click '''Save'''
		+	Payments and subscriptions made via the PayPal Basic module will continue to be recorded in WHMCS even with IPNs disabled at the account level.

@@ Line 21: / Line 21: @@
 A popup will open prompting you to sign in to your PayPal account in order to link it to your WHMCS installation and automatically configure the new module.  Complete the process as provided by PayPal to link your PayPal account.
-===Step 2: Deactivate the PayPal Basic module===
+===Step 2: Hide the PayPal Basic module===
 The new PayPal Checkout module is not a direct replacement for the PayPal module that existed before it.
-If you have PayPal Subscriptions that were setup either via the previous official PayPal integration from WHMCS (now known as "PayPal Basic"), or via a custom or 3rd party PayPal integration that were later migrated to WHMCS, it is important that you do not deactivate the "PayPal Basic" module. The PayPal Basic module must be kept active in order for recurring payments made via these subscriptions to continue to be recognised and applied automatically.
+If you have PayPal Subscriptions that were setup either via the previous official PayPal integration from WHMCS (now known as "PayPal Basic"), or via a custom or 3rd party PayPal integration that were later migrated to WHMCS, it is important that you '''do not deactivate''' the "PayPal Basic" module. The PayPal Basic module must be kept active in order for recurring payments made via these subscriptions to continue to be recognised and applied automatically.
+[[File:Paypal_hide_order_form.png|thumb|Uncheck Show on Order Form]]
 # Navigate to Setup > Payment Gateways > Manage Existing Gateways.
 # Locate the PayPal Basic module.

@@ Line 43: / Line 43: @@
 UPDATE tblhosting SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';<br>
 UPDATE tblhostingaddons SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';<br>
-UPDATE tbldomains SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';
+UPDATE tbldomains SET paymentmethod='paypalcheckout' WHERE paymentmethod='paypal';<br>
 </div>
-This will update all products, services, addons and domains to use the new PayPal Checkout module while leaving the previous module active to be able to continue to receive and handle IPN notification of payments appropriately.
+This will update all products, services, addons, domains and draft/unpaid invoices to use the new PayPal Checkout integration to allow users to benefit from the optimised checkout workflow and subscription information procedure.