The PayPal Website Payments Pro payment gateway module is available in WHMCS.

Supported Features #

Type: Merchant (Credit Card)

Adding the PayPal Website Payments Pro Payment Gateway #

To set up the PayPal Website Payments Pro payment gateway in WHMCS:

1. Go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
2. Click PayPal Website Payments Pro.
3. Check Show on Order Form to display this payment method in the Client Area during checkout.
4. Retrieve your details for the PayPal 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.
5. Enter your PayPal credentials. Processor ID, Merchant ID, and Transaction PW are part of the 3D Secure process.
   • PayPal Pro accounts use 3D Secure by default. PayPal will provide your 3D Secure details.
   • Leave these values blank in WHMCS to disable 3D Secure.
6. Click Save Changes.

Test Mode #

You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful for testing your configuration.

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 allows repeated payments. Whenever a client pays manually via the Client Area, the system stores it as the most recent transaction to make further repeats 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 displays in the debug field. Check the L_ERRORCODE0 value, and the following two values will explain the error.

L_SHORTMESSAGE0 => Security error indicates that the API details you entered at **Configuration () > System Settings > Payment Gateways are invalid.

Troubleshooting #

N/A

Last modified: October 30, 2024