Revision as of 18:26, 15 September 2021 (view source) SarahK (talk | contribs) ← Older edit		Revision as of 11:16, 21 September 2021 (view source) AlexN (talk | contribs) m Newer edit →
Line 45:		Line 45:
	| refunds = yes		| refunds = yes
	| level = 3		| level = 3
		+	| addpaymethod = yes
	}}		}}

---

Revision as of 11:16, 21 September 2021

Supported Features

Type	One Time	Recurring	Refunds	3D Secure
Credit Card	Yes	Yes	Yes	Yes

Configuration

To activate the module:

1. Go to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Payments > Payment Gateways.
2. Choose "PayPal Website Payments Pro" from the available list of gateways to activate.
3. Enter the details provided by PayPal® (API Username, API Password, and API Signature).
4. Click Save Changes to start accepting payments.

3D Secure

Processor ID, Merchant ID, and Transaction PW are used by the 3D Secure process. PayPal Pro Accounts are usually enrolled for this by default. If you are enrolled, PayPal will provide the details.

If they haven't or you don't want to use the 3D Secure feature, leave these fields blank. This will disable the 3D Secure process and ensure that it is not used during the checkout process.

API Details

After activation, you must enter your details for the Payflow Pro API:

1. Log in to PayPal.
2. Select your name and company at the top right.
3. From the menu, select Account settings.
4. Scroll down and select Website payments.
5. Select Update for API Access.
6. Under NVP/SOAP API integration (classic), select Manage API credentials.
7. Copy the API credentials.

Reference Payments

This feature helps reduce your PCI compliance liability. Instead of storing card details in WHMCS, the ID of the last transaction is used to make repeat charges. Changing payment gateways requires clients to reenter their card details.

Supported Features

Type	One Time	Recurring	Refunds	3D Secure
Token	Yes	Yes	Yes	No

Remote Update Card	Remote Delete Card	AddPayMethod API
No	No	Yes

Configuration

To activate the module:

1. Go to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Payments > Payment Gateways.
2. Choose PayPal Pro Reference Payments from the available list of gateways.
3. Enter the details provided by PayPal® (Partner, Merchant Login, Username, and Password).
4. Check Use Reference Transactions.
5. Click Save Changes.
6. Go to Configuration () > System Settings > General Settings.
7. Select the Security tab.
8. Uncheck Allow Client Pay Method Removal.
9. Click Save Changes to start accepting reference payments.

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.

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

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 L_ERRORCODE0 value, and the following two values will then briefly explain the error.

L_SHORTMESSAGE0 => Security error indicates that the API details you entered at Configuration () > 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, click here.