LCWSoft PayPal Billing Agreements

LCWSoft PayPal Billing Agreements

Developed By LCWSoft

Compatible with WHMCS v8.10


This module enables you to create PayPal Billing Agreements and process manual and automatic recurring payments in the same way as a credit card. A great alternative for processing recurring payments without the restrictions of PayPal Subscriptions.

Migration from other modules that offer PayPal Billing Agreements is supported.


No special server configuration needed. You will need API details from your PayPal account and "Reference Transactions" enabled on it by PayPal Merchant Support.


It is $6.00 CAD monthly (or $60 CAD annually - essentially getting 12 months for the price of 10) with free support & updates for as long as your service is Active.


Download the zip file from our client area and follow the instructions in the INSTALL.txt file included.



5 stars
4 stars
3 stars
2 stars
1 star

Mor H @mor8844

March 29, 2023 at 10:10:41 PM

Amazing module! Did exactly what we needed.
Documentation could be improved as it is a bit hard to find all the information. @LCWSoft, it would be very helpful if we could have a single place/page that has all the documentation that one needs to understand the module and all of its options.

  • 1 year ago
  • Version Number 1.1.9

Skystra Cloud @curtis4784

December 17, 2021 at 03:58:34 AM

LCWSoft came through with our request in a timely and professional manner, it works exactly as expected. Great development team!

  • 2 years ago
  • Version Number 1.0.9

Ali @ali2023

March 15, 2021 at 05:13:53 PM

Am really impressed with this Payment Gateway.. It just works! and would like to say thanks to the developer for making this available. Must have addon for whmcs.

1. Please add a function to remove gateway token if client cancels the billing agreement on their end and ViceVersa, we should be able to cancel the billing agreement on the whmcs billing panel if client requests this.
2. We need a new version notification system in place if the developer releases an update.
3. Add an option that allows client to choose Subscribe or Checkout.

  • 3 years ago
  • Version Number 1.0.6
  • Edited

José Manuel Giner @jmginer

March 2, 2021 at 09:06:43 AM

We have installed the payment module and we can say that it fulfills its function perfectly: The customer enters his first payment in Paypal and a consent is registered which allows us to invoice him on demand.

It considers the Paypal consent as if it were a credit card.

It includes the migration of subscriptions created by the obsolete Myworks module.

As improvements, we will say that:

- There is no option to create a consent, you have to force the customer to pay an existing invoice.

- If the customer cancels his consent in his Paypal account, it is not reflected in the WHMCS customer area.

These are two features that were in MyWorks with the old system and were lost with the latest WHMCS 7.8 update.

Lawrence Williams @LCWSoft

March 10, 2021 at 02:22:17 AM

Thank you for the kind words. Regarding your ideas for improvements, both are items we are looking into - but present technical hurdles at this time

1) Currently PayPal employs code that breaks their consent page out of the iframe offered by WHMCS when adding/editing a Pay Methods and there isn't a simple way to correctly redirect back to a client area page that confirms to the client that their billing agreement was created successfully. If that changes, we will certainly implement it.

2) Unfortunately this is not possible to handle for Myworks created billing agreements due to the details their module sent to PayPal (or lack of) and being unable to redirect the IPN notification from PayPal accordingly. For Billing Agreements created via our module, that will work as expected. For Billing Agreements created with the MyWorks module, we can only remove them if a payment is attempted and PayPal's response indicates the Billing Agreement was cancelled at PayPal.

  • 3 years ago
  • Version Number 1.0.5

Darren Cain @darren2203

February 1, 2021 at 05:43:28 PM

Switched from another PP Agreement module, due to no customer support.

LCWSoft helped migrate the existing client PP agreements and it works as expected. I'm running the latest stable WHMCS.

  • 3 years ago
  • Version Number 1.0.5
  • Edited

Sha Mon @sha4029

December 19, 2020 at 12:29:56 AM

No comment provided.

  • 3 years ago
  • Version Number 1.0.4

Version Compatibility

Compatible with WHMCS v8.10

Full Version Compatibility

  • Selected versions of WHMCS v8.10
  • Selected versions of WHMCS v8.9
  • Selected versions of WHMCS v8.8
  • All versions of WHMCS v8.7
  • All versions of WHMCS v8.6
  • All versions of WHMCS v8.5
  • All versions of WHMCS v8.4
  • All versions of WHMCS v8.3
  • All versions of WHMCS v8.2
  • All versions of WHMCS v8.1
  • All versions of WHMCS v8.0

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By LCWSoft


v1.2.3 Released September 21st, 2023

Latest Version

  • Updated to handle payments held for review by PayPal. Invoices will be set to Payment Pending status and changed to Paid once PayPal releases the payment.


Previous Versions

v1.1.9 Released February 10th, 2023

View/hide detailed changelog

  • Corrected potential account balance widget bug when a particular currency is more than 1000 dollars or contains nonstandard formatting.
  • Replaced default button recommendations on new installations (new recommended buttons are mentioned in the settings descriptions for them as well).
  • Clarified title of the homepage widget so that it's obvious that the data is the current PayPal account balance - not the transactions in WHMCS itself.


v1.1.8 Released November 23rd, 2022

View/hide detailed changelog

  • Added PHP 8.1 support for WHMCS 8.6


v1.1.2 Released February 12th, 2022

View/hide detailed changelog

  • Added JavaScript to disable payment buttons after being clicked to prevent duplicate payments being processed.


v1.1.1 Released December 31st, 2021

View/hide detailed changelog

  • New feature: optional ability to create billing agreements via the Pay Methods page in the client area (without paying an invoice or placing an order)
  • New feature: support for translating language strings displayed on the client area using custom language files and overrides in the /modules/gateways/lcwsoftpaypalbillingagreements/lang folder. english.php is shipped and used by default, and should be followed when creating custom languages (for example: french.php).


v1.1.0 Released December 15th, 2021

View/hide detailed changelog

  • New feature: support for custom e-mail templates and a button to generate or restore them to their default content as needed.
  • New feature: support for displaying the PayPal balance for all configured currencies in WHMCS. Requires WHMCS 8.2 or newer and will appear on the admin summary page for admins who are assigned to a role that has the "View Gateway Balances" permission enabled.
  • New feature: support for redirecting to PayPal to create a billing agreement if the order is free (free items or $0.00 total). Useful when offering free trials that update to paid products.


v1.0.9 Released December 2nd, 2021

View/hide detailed changelog

  • New feature: allow clients to make one time payments using the existing PayPal billing agreement even if "Allow One Time Payments without a Billing Agreement" is disabled. New optional settings "Allow One Time Payments using existing Billing Agreement" controls this.
  • Added text to both one time payment options to describe whether an existing billing agreement will be used or not.


v1.0.8 Released September 24th, 2021

View/hide detailed changelog

  • New feature: automatically cancel the PayPal Billing Agreement when deleting the Pay Method via the client or admin area
  • Added the PayPal error code (not just the short error message) to the transaction history entry when an automatic payment attempt is declined by PayPal
  • Improved error reporting when a core or helper file is missing unexpectedly


v1.0.7 Released July 12th, 2021

View/hide detailed changelog

  • Reworked payment buttons code to resolve an issue with some third party customisations that could potentially result in double payments


v1.0.6 Released March 8th, 2021

View/hide detailed changelog

  • Added support for changing the CSS used to display the payment buttons (re-saving gateway settings will be necessary after updating)
  • Migrated billing agreements now set the description to "Migrated" so they can more easily identified later


v1.0.5 Released January 27th, 2021

View/hide detailed changelog

  • Implemented functionality on the gateway settings page to migrate existing PayPal Billing Agreements from other third party modules
  • Improved decoding of PayPal API response for the "Billing Agreement Charge Successful" gateway log entry


v1.0.4 Released November 19th, 2020

View/hide detailed changelog

  • Implemented IPN support
  • Implemented PaymentReversed gateway function, so that WHMCS can undo the payment if PayPal sends usable IPN data that we can use to confirm that a chargeback/dispute has occurred.
  • Implemented Pay Method deletion if a client cancels their billing agreement at PayPal (requires IPN to be active at PayPal and only applies to billing agreements created after updating)
  • Bug fix: removed the optional Invoice ID from the RefundTransaction API call during refunds, otherwise PayPal could return a duplicate invoice ID when trying to refund a transaction. This should allow multiple installations to share 1 PayPal account and process refunds without issue.
  • Added support for specifying the logo using on PayPal checkout pages
  • Added version number to configuration section for easier verification.


v1.0.3 Released November 2nd, 2020

View/hide detailed changelog

  • Fixed a potential blank page on returning to WHMCS if the payment request was rejected by PayPal unexpectedly after the Billing Agreement was created.


v1.0.2 Released October 15th, 2020

View/hide detailed changelog

  • Minor bug fixes and quality of life improvements


v1.0.1 Released October 5th, 2020

View/hide detailed changelog

  • Minor bug fixes and quality of life improvements


v1.0 Released September 14th, 2020

View/hide detailed changelog

  • Initial release


See also

WHMCS Bitcoin Payments

Accept Bitcoin payments on your website

Accept Bitcoin and cryptocurrency payments - CoinGate for WHMCS

Easily accept Bitcoin, Tether, Ethereum and many other crypto payments on your WHMCS website

Coinbase Commerce

No Fees, Easy Setup. Accept cryptocurrencies like: Bitcoin, Bitcoin Cash, Ethereum and Litecoin!

Gateway Fees for WHMCS

With this WHMCS module, you'll get the payment gateway fees from your clients directly.

PayTR Virtual Pos iFrame API

Open your web site to shopping with the advantages of PayTR. Take your payments securely.