PayPal Checkout - Revision history

SarahK: /* About this Module */

2024-03-06T16:03:51Z

‎About this Module

SarahK: /* About this Module */

2024-03-06T16:03:39Z

‎About this Module

SarahK: /* Disputes */

2024-02-07T17:02:24Z

‎Disputes

SarahK: /* Disputes */

2023-12-06T20:35:31Z

‎Disputes

SarahK: /* About this Module */

2023-12-06T20:35:07Z

‎About this Module

SarahK: /* Troubleshooting */

2023-04-26T19:01:46Z

‎Troubleshooting

SarahK: /* Troubleshooting */

2023-04-26T19:00:56Z

‎Troubleshooting

SarahK at 12:38, 29 September 2022

2022-09-29T12:38:59Z

SarahK: /* Adding the PayPal Payment Gateway */

2022-09-28T19:02:00Z

‎Adding the PayPal Payment Gateway

SarahK: /* Adding the PayPal Payment Gateway */

2022-09-07T20:50:48Z

‎Adding the PayPal Payment Gateway

@@ Line 2: / Line 2: @@
 <div class="docs-alert-success">
-- In WHMCS 8.9 and later, we '''strongly''' recommend the '''[[PayPal Payments]]''' payment gateway module for processing payments with PayPal. This module includes all of the latest features for securely processing payments via PayPal, including support for credit and debit cards.
+* In WHMCS 8.9 and later, we '''strongly''' recommend the '''[[PayPal Payments]]''' payment gateway module for processing payments with PayPal. This module includes all of the latest features for securely processing payments via PayPal, including support for credit and debit cards.
-- We added this PayPal module in WHMCS 7.9. For information on all of our PayPal integrations, see [[PayPal]].
+* We added this PayPal module in WHMCS 7.9. For information on all of our PayPal integrations, see [[PayPal]].
 </div>

@@ Line 1: / Line 1: @@
 == About this Module ==
-−
 <div class="docs-alert-success">
-We added this PayPal module in WHMCS 7.9. For information on all of our PayPal integrations, see [[PayPal]].
+- In WHMCS 8.9 and later, we '''strongly''' recommend the '''[[PayPal Payments]]''' payment gateway module for processing payments with PayPal. This module includes all of the latest features for securely processing payments via PayPal, including support for credit and debit cards.
 </div>

@@ Line 89: / Line 89: @@
 == Disputes ==
-WHMCS 8.3 and higher includes support for disputes for Stripe and PayPal Checkout transactions at '''Billing > [[Disputes]]'''.
+In WHMCS 8.3 and higher, you can manage disputes for this module from within WHMCS at '''Billing > [[Disputes]]'''.
 == Troubleshooting ==

@@ Line 88: / Line 88: @@
 == Disputes ==
-−
-WHMCS 8.3 and higher includes support for disputes for Stripe and PayPal® transactions at '''Billing > [[Disputes]]'''.
+WHMCS 8.3 and higher includes support for disputes for Stripe and PayPal Checkout transactions at '''Billing > [[Disputes]]'''.
 == Troubleshooting ==

@@ Line 1: / Line 1: @@
 == About this Module ==
-−
 <div class="docs-alert-success">
-We added this PayPal module in WHMCS 7.9. WHMCS also includes a [[PayPal Basic]] module.
+We added this PayPal module in WHMCS 7.9. For information on all of our PayPal integrations, see [[PayPal]].
 </div>
-−
 PayPal Checkout with Smart Payment Buttons gives your buyers a simplified and secure checkout experience. PayPal Checkout presents the most relevant payment types with methods like Pay with Venmo, PayPal Credit, credit card payments, iDEAL, Bancontact, Sofort, and other payment types.
 {{gateways
@@ Line 11: / Line 11: @@
 | refunds = yes
 }}
 == Adding the PayPal Payment Gateway ==

@@ Line 100: / Line 100: @@
 This message indicates that the subscription is not associated with any service, addon, or domain in the WHMCS database for your installation. However, the system did find an alternate ID to use to identify an associated invoice or client.
-If this message begins with [PAYMENT.SALE.COMPLETED], there is not an immediate issue, but you should review the subscription in order to understand why the ID is missing.
+If this message begins with <tt>[PAYMENT.SALE.COMPLETED]</tt>, there is not an immediate issue, but you should review the subscription in order to understand why the ID is missing.
 * If the subscription is active, update the ID to associate the subscription with the relevant service. If you do not, the message will repeat for each payment.
@@ Line 109: / Line 109: @@
 This message indicates that the subscription is not associated with any service, addon, or domain in the WHMCS database for your installation. Additionally, the system could not find an alternate ID to use to identify an associated invoice or client.
-* If this message begins with [PAYMENT.SALE.COMPLETED] and you updated to WHMCS 8.7.2 ***more*** than 48 hours ago, there is a ***serious problem***. The PayPal account received payment, but WHMCS has not recorded it. Investigate the issue immediately to determine the necessary action.
+* If this message begins with <tt>[PAYMENT.SALE.COMPLETED]</tt> and you updated to WHMCS 8.7.2 '''more''' than 48 hours ago, there is a '''serious problem'''. The PayPal account received payment, but WHMCS has not recorded it. Investigate the issue immediately to determine the necessary action.
-* If this message begins with [BILLING.SUBSCRIPTION.CREATED] and you updated to WHMCS 8.7.2 within the last 48 hours, this is a normal indicator that a user checked out using PayPal just before you upgraded. You do not need to take further action.
+* If this message begins with <tt>[BILLING.SUBSCRIPTION.CREATED]</tt> and you updated to WHMCS 8.7.2 within the last 48 hours, this is a normal indicator that a user checked out using PayPal just before you upgraded. You do not need to take further action.
 === Missing Payments in WHMCS ===

@@ Line 91: / Line 91: @@
 == Troubleshooting ==
-The explanations and resolutions for common problems are listed below:
+=== Missing and Orphaned Subscriptions ===
-===Signature Verification Failed===
+If this message begins with [PAYMENT.SALE.COMPLETED], there is not an immediate issue, but you should review the subscription in order to understand why the ID is missing.
-''Signature Verification Failed'' indicates a problem in the payment notification anti-spoof verification. When a payment notification is received from PayPal, WHMCS makes an API request to PayPal confirming that the notification originated from PayPal.
+* If the subscription is active, update the ID to associate the subscription with the relevant service. If you do not, the message will repeat for each payment.
-Seeing this typically indicates that a subscription renewal payment was made through a different [https://developer.paypal.com/docs/integration/admin/manage-apps/# integration app] from the one currently linked to your WHMCS installation.
+This message indicates that the subscription is not associated with any service, addon, or domain in the WHMCS database for your installation. Additionally, the system could not find an alternate ID to use to identify an associated invoice or client.
-This situation can arise if '''Unlink PayPal Account''' on the module configuration was used after the PayPal subscription was originally created. Once the unlink function is used, the subscription payments that pre-date it can no longer be recorded in WHMCS. Such subscriptions will need to be cancelled via the PayPal website. Clients can then create a new subscription under the current integration app linked to your WHMCS installation when their next invoice is due.
+* If this message begins with [PAYMENT.SALE.COMPLETED] and you updated to WHMCS 8.7.2 ***more*** than 48 hours ago, there is a ***serious problem***. The PayPal account received payment, but WHMCS has not recorded it. Investigate the issue immediately to determine the necessary action.
-===An unknown error occurred. Please try again===
+=== Missing Payments in WHMCS ===
 ''unknown error occurred'' will be displayed if data saved by the PayPal payment button is invalid, such as the amount, client's name, email address, postal address, postal code, or country code.
-−
 To capture more details, use the [[Troubleshooting_Module_Problems|Module Debug Log]]. Examine the logged request and response data. It should become apparent what data is missing or incomplete from the client's profile. For example:
-−
 '''Request:'''
 <div class="source-cli">
@@ Line 117: / Line 139: @@
 "address":{"address_line_1":"123 Test Street","postal_code":"ABC 123","country_code":""}}}
 </div>
-−
 '''Response:'''
 <div class="source-cli">
@@ Line 125: / Line 147: @@
 The value of a field is either too short or too long."},
 </div>
-−
 In this case, the '''Country Code''' at the end of the request is empty. To correct this, go to '''Profile''' for the client and ensure that a country is selected. Then, click '''Save Changes'''.
 If the '''currency_code''' value is not amongst [https://developer.paypal.com/docs/api/reference/currency-codes/#paypal-account-payments PayPal API's supported currency list] then the PayPal Basic module can be used as an alternative in conjunction with the [[Payment_Gateways#Setting_Up_Gateway_Modules|Convert to For Processing setting]] to transparently convert the payment amounts into a currency which is supported by PayPal.
-−
 {{modules}}

← Older revision		Revision as of 12:38, 29 September 2022
Line 31:		Line 31:

	=== Limitations and Restrictions ===		=== Limitations and Restrictions ===
		+
		+	<div class="docs-alert-warning">
		+	This module requires an HTTPS-secured connection. If the WHMCS installation's domain does not have a valid SSL certificate or the '''[[General_Tab\|WHMCS System URL]]''' value does not begin with <tt>https://</tt>, the connection between WHMCS and PayPal will not work.
		+
		+	For more information, see [https://go.whmcs.com/1705/ssl-learn-more PayPal Checkout SSL Requirement].
		+	</div>

	The following limitations and restrictions apply to PayPal Checkout:		The following limitations and restrictions apply to PayPal Checkout:

@@ Line 17: / Line 17: @@
 # Ensure that your WHMCS installation uses an HTTPS-secured connection with a valid [https://www.whmcs.com/ssl-certificates SSL certificate]. If it does not, this module will not function correctly.
 # Go to the appropriate location for your version of WHMCS:
-#* For WHMCS 8.6 and later, go to '''Addons > [[Apps and Integrations|Apps & Integrations]]''' or '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > Apps & Integrations'''.
+#* For WHMCS 8.0 and later, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > Apps & Integrations''' or '''Addons > [[Apps and Integrations|Apps & Integrations]]'''.
-#* For WHMCS 8.0 to 8.6, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' and choose '''All Payment Gateways'''.
+#* For WHMCS 7.10 and earlier, go to '''Setup > Products/Services > [[Payment Gateways]]''' and choose '''All Payment Gateways'''.
 # Click '''Activate & Configure''' for '''PayPal'''.
 # When the system prompts you, log in to your existing PayPal account or sign up for a new one.

@@ Line 16: / Line 16: @@
 # Ensure that your WHMCS installation uses an HTTPS-secured connection with a valid [https://www.whmcs.com/ssl-certificates SSL certificate]. If it does not, this module will not function correctly.
-# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Payment Gateways'''.
+# Go to the appropriate location for your version of WHMCS:
-# Choose the '''Featured Payment Gateways''' tab.
+#* For WHMCS 8.6 and later, go to '''Addons > [[Apps and Integrations|Apps & Integrations]]''' or '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > Apps & Integrations'''.
 # Click '''Activate & Configure''' for '''PayPal'''.
 # When the system prompts you, log in to your existing PayPal account or sign up for a new one.
@@ Line 59: / Line 61: @@
 # Update the '''Webhook URL''' to the correct address, ending with <tt>/modules/gateways/callback/paypalwebhooks.php</tt>.
 # Click '''Save'''.
-−
 == Checkout ==