PayPal Basic - Revision history

SarahK: /* About this Module */

2024-03-06T16:04:15Z

‎About this Module

2023-12-06T20:34:49Z

‎About this Module

2023-09-20T09:01:41Z

‎Adding the PayPal Basic Payment Gateway

2022-10-27T14:48:03Z

‎About this Module

2022-09-28T19:02:22Z

‎Adding the PayPal Basic Payment Gateway

2022-09-07T20:50:19Z

‎Adding the PayPal Basic Payment Gateway

2022-04-27T20:06:41Z

‎Unrecognised Currency

2022-04-27T20:05:43Z

‎Invalid Receiver Email

2022-04-19T10:54:48Z

‎Instant Payment Notification (IPN)

2022-04-19T10:54:07Z

‎Instant Payment Notification (IPN)

@@ 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 ==
-−
-<div class="docs-alert-info"><i class="fa fa-info-circle"></i> In previous versions, the '''PayPal Basic''' module was the '''PayPal''' module. For information on the newest PayPal module, see '''[[PayPal Checkout]]'''.
+<div class="docs-alert-info">
 </div>
-−
 The PayPal Basic payment gateway module is available in WHMCS.
 {{gateways

@@ Line 29: / Line 29: @@
 ## For '''Require Shipping Address''', check to require clients to provide a shipping address on the PayPal website and will be associated with their payment at PayPal, useful when selling physical products and for PayPal's Seller Protection.
 ## For '''Client Address Matching''', check to ensure that the details the client provides in WHMCS upon ordering  will be used associated with their payment at PayPal. They will not be given the opportunity to provide different details on the PayPal website. Clients can update their profile via the WHMCS client area or your staff can use the '''Profile''' tab.
-## For '''API Username''', '''API Password''', and '''API Signature''', enter the credentials at '''Tools > All Tools > API Credentials''' in the PayPal Business dashboard.
+## For '''API Username''', '''API Password''', and '''API Signature''', enter the credentials from your PayPal account:
 ##* This allows you to issue refunds from within WHMCS instead of logging in via PayPal.
 ##* For more information refer to [[#Automated_Refunds|Automated Refunds]]

@@ Line 1: / Line 1: @@
 == About this Module ==
-<div class="docs-alert-info"><i class="fa fa-info-circle"></i> PayPal Basic was formerly known as "PayPal"<br/>
+<div class="docs-alert-info"><i class="fa fa-info-circle"></i> In previous versions, the '''PayPal Basic''' module was the '''PayPal''' module. For information on the newest PayPal module, see '''[[PayPal Checkout]]'''.
-Looking for the newest PayPal module documentation? [[PayPal_Checkout|Go here]]</div>
+</div>
 The PayPal Basic payment gateway module is available in WHMCS.
@@ Line 11: / Line 11: @@
 | reversals = yes
 }}
 == Adding the PayPal Basic Payment Gateway ==

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

@@ Line 120: / Line 120: @@
 ===Unrecognised Currency===
-This error in the Gateway Log means an invalid currency code has been entered under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Currencies''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies'''. A currency code must use the ISO 4217 standard as explained on the [[Currencies]] page. For example EURO is not valid, but EUR is valid.
+This error in the Gateway Log means an invalid currency code has been entered under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Currencies]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies'''. A currency code must use the ISO 4217 standard as explained on the [[Currencies]] page. For example EURO is not valid, but EUR is valid.
 This could also be caused by a blank space at the beginning or end of the currency code, so edit the code to ensure there are none.

@@ Line 112: / Line 112: @@
 ===Invalid Receiver Email===
-WHMCS validates the payment receiver email value against the details specified under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Payment Gateways''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways''', so this error means the two do not match. If multiple PayPal accounts are used to receive payment, or a single PayPal account has multiple email addresses associated with it ,they must all be listed in a comma separated list eg. email1@mycompany.com,email2@mycompany.com.
+WHMCS validates the payment receiver email value against the details specified under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways''', so this error means the two do not match. If multiple PayPal accounts are used to receive payment, or a single PayPal account has multiple email addresses associated with it ,they must all be listed in a comma separated list eg. email1@mycompany.com,email2@mycompany.com.
 The first email you specify will then be the email used for new payments, but any email in the field will be accepted as an invoice payment.

@@ Line 41: / Line 41: @@
 ==Instant Payment Notification (IPN)==
-[[File:paypalipn2.png|thumb|PayPal IPN Setup]]
+[[File:paypalcharsetnew.png|thumb|PayPal IPN Setup]]
 For PayPal invoices to be automatically marked paid when you receive a payment you need to enable IPN inside your PayPal account.
@@ Line 57: / Line 57: @@
 ===Charset Configuration===
-[[File:paypalcharsetnew.png|thumb|PayPal Charset Configuration]]
+[[File:paypalcharset.png|thumb|PayPal Charset Configuration]]
 PayPal defaults the charset used for most accounts to windows-1252. Whilst this is acceptable and will not cause an issue for most users, on occasion, accented characters can be returned incorrectly through the IPN causing the IPN Handshake Invalid message. Setting the charset in your PayPal account to match your WHMCS installation is a recommended setting to ensure this issue does not occur. The default value is '''UTF-8'''.