PayPal Website Payments Pro

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

  • 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.
  • For information on all of our PayPal integrations, see Accepting PayPal.

Supported Features

Type: Merchant (Credit Card)

3D SecureRemote Update CardRemote Delete CardAddPayMethod API

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.


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.

For more detailed descriptions of the errors and instructions for correcting them, see PayPal’s NVP SOAP Errors documentation.



Last modified: June 14, 2024