PayPal Website Payments Pro - Revision history

SarahK: /* About this Module */

2024-03-06T16:04:54Z

‎About this Module

SarahK: /* About this Module */

2023-12-06T20:43:02Z

‎About this Module

SarahK: /* Adding the PayPal Pro Reference Payments Payment Gateway */

2022-09-28T19:01:43Z

‎Adding the PayPal Pro Reference Payments Payment Gateway

SarahK: /* Adding the PayPal Website Payments Pro Payment Gateway */

2022-09-28T19:01:27Z

‎Adding the PayPal Website Payments Pro Payment Gateway

SarahK: /* Adding the PayPal Pro Reference Payments Payment Gateway */

2022-09-07T20:52:38Z

‎Adding the PayPal Pro Reference Payments Payment Gateway

SarahK: /* Adding the PayPal Website Payments Pro Payment Gateway */

2022-09-07T20:51:03Z

‎Adding the PayPal Website Payments Pro Payment Gateway

James.white: /* Declined Payments */

2022-06-01T13:31:00Z

‎Declined Payments

SarahK: /* Declined Payments */

2022-04-27T20:27:33Z

‎Declined Payments

SarahK at 21:16, 31 March 2022

2022-03-31T21:16:14Z

AlexN at 11:16, 21 September 2021

2021-09-21T11:16:53Z

@@ Line 1: / Line 1: @@
 == About this Module ==
-−
 <div class="docs-alert-info">
 For information on all of our PayPal integrations, see [[PayPal]].

@@ Line 1: / Line 1: @@
 == About this Module ==
-−
 The PayPal Website Payments Pro payment gateway module is available in WHMCS.
 {{gateways
@@ Line 9: / Line 13: @@
 | 3dsecure = yes
 }}
 == Adding the PayPal Website Payments Pro Payment Gateway==

@@ Line 55: / Line 55: @@
 # 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 '''PayPal Pro Reference Payments'''.
 # Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.

@@ Line 14: / Line 14: @@
 # 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 '''PayPal Website Payments Pro'''.
 # Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.

@@ Line 55: / Line 55: @@
 To set up this payment gateway in WHMCS:
-# 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 '''All 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 '''PayPal Pro Reference Payments'''.
 # Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.

@@ Line 83: / Line 83: @@
 <tt>L_SHORTMESSAGE0 => Security error</tt> indicates that the API details you entered at '''Configuration  (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways''' are invalid.
-For more detailed descriptions of the errors and instructions for correcting them, [https://cms.paypal.com/uk/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_errorcodes click here].
+For more detailed descriptions of the errors and instructions for correcting them, [https://developer.paypal.com/api/nvp-soap/errors/ click here].
 == Troubleshooting ==

@@ Line 79: / Line 79: @@
 == Declined Payments ==
-If you experience an error while processing payments, go to '''Billing > Gateway Log'''. The full response from PayPal is displayed in the debug field. Refer to the <tt>L_ERRORCODE0</tt> value, and the following two values will then briefly explain the error.
+If you experience an error while processing payments, go to '''Billing > [[Gateway Log]]'''. The full response from PayPal is displayed in the debug field. Refer to the <tt>L_ERRORCODE0</tt> value, and the following two values will then briefly explain the error.
-<tt>L_SHORTMESSAGE0 => Security error</tt> indicates that the API details you entered at '''Configuration  (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Payment Gateways''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways''' are invalid.
+<tt>L_SHORTMESSAGE0 => Security error</tt> indicates that the API details you entered at '''Configuration  (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways''' are invalid.
 For more detailed descriptions of the errors and instructions for correcting them, [https://cms.paypal.com/uk/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_errorcodes click here].

@@ Line 1: / Line 1: @@
 {{gateways
 | type = cc
@@ Line 6: / Line 9: @@
 | 3dsecure = yes
 }}
-==Configuration==
+To set up the PayPal Website Payments Pro payment gateway in WHMCS:
-To activate the module:
+=== Test Mode ===
-===3D Secure===
+You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.
 {{gateways
 | type = token
@@ Line 48: / Line 49: @@
 }}
-<div class="docs-alert-warning">
+=== Adding the PayPal Pro Reference Payments Payment Gateway ===
-'''Note: ''' This module does not support adding or updating card data via the Admin Area. To do this, pay an invoice on behalf of a client.
-</div>
+To set up this payment gateway in WHMCS:
-−
-===Configuration===
+# 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'''.
+# Choose the '''All Payment Gateways''' tab.
-To activate the module:
+# Click '''PayPal Pro Reference Payments'''.
-# Go to '''Configuration  (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Payment Gateways''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways'''.
+# Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.
-# Choose '''PayPal Pro Reference Payments''' from the available list of gateways.
+# Enter your PayPal Pro Reference Payments credentials.
-# Enter the details provided by PayPal® ('''Partner''', '''Merchant Login''', '''Username''', and '''Password''').
+#* '''Processor ID''', '''Merchant ID''', and '''Transaction PW''' are used by the 3D Secure process.
-# Check '''Use Reference Transactions'''.
+#** PayPal Pro accounts are enrolled for this by default. If you are enrolled, PayPal will provide details.
 # Click '''Save Changes'''.
-===Limitations===
+== Limitations ==
 PayPal applies a time limit for repeating against a transaction. 24 months after the original payment, you will see a '''Referenced transaction or order is too old''' error.
@@ Line 71: / Line 77: @@
 To resolve this, the client must log in and submit payment manually. This will generate a new transaction that further repeats can be made against. Whenever a client pays manually via the Client Area, it is stored as the most recent transaction for any further repeats to be made against. The standard "Credit Card Payment Declined" email template will send to a client when the capture fails due to the expired reference transaction.
-==Declined Payments==
+== Declined Payments ==
 If you experience an error while processing payments, go to '''Billing > Gateway Log'''. The full response from PayPal is displayed in the debug field. Refer to the <tt>L_ERRORCODE0</tt> value, and the following two values will then briefly explain the error.
@@ Line 78: / Line 84: @@
 For more detailed descriptions of the errors and instructions for correcting them, [https://cms.paypal.com/uk/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_errorcodes click here].
 {{modules}}

@@ Line 45: / Line 45: @@
 | refunds = yes
 | level = 3
 }}