8.9 Release Notes

This WHMCS version is currently a Long-Term Support status.

Download Now or go to Utilities > Update WHMCS

Release Highlights

WHMCS 8.9 introduces new PayPal® payment gateway modules, extends on-demand renewals to allow early renewals for product addons, and separates admin abilities to view and manage invoices.

Learn about the newest features and most important updates in our 8.9 Release Highlights.

Version History

Latest UpdateVersionRelease Type
03-06-20248.9.0General Availability
02-07-20248.9.0Release Candidate
The anticipated End-of-Life date for this version is January 31st, 2025.

Upgrade Requirements

Before upgrading to this WHMCS version, make certain that your system meets the following requirements:

DependencyMinimum RequirementRecommended
ionCube® LoaderionCube Loader 10.2.0ionCube Loader 12.0.1
MySQL®MySQL 5.2MySQL 8.0
  • Updates only appear at Utilities > Update WHMCS if you are running a compatible PHP version.
  • For more information and a list of required PHP extensions and other requirements, see System Requirements.

New Features

New PayPal® Payment Gateways

The new PayPal Payments payment gateway module allows merchants to process and store payment methods using PayPal’s latest secure tokenization system, including the advanced security of merchant-level vaulting with PayPal Vault for supported merchants.

PayPal currently enables vaulting for merchants in the United States, Canada, the United Kingdom, Australia, and the following EU countries:

Belgium, Bulgaria, The Republic of Cyprus, Czech Republic, Germany, Denmark, Estonia, Spain, Finland, France, Greece, Hungary, Italy, Lithuania, Luxembourg, Latvia, Malta, Netherland, Poland, Portugal, Romania, Sweden, Slovenia, and Slovakia.

When you use PayPal Payments, clients can make one-click payments using PayPal Smart Buttons during checkout and on invoices.

When you activate PayPal Payments, it also activates the PayPal Card Payments module. This module augments PayPal Payments, allowing you to display a separate unbranded option to accept credit and debit cards during checkout.

Both modules use PayPal Payments’s configured PayPal account information for a seamless experience.

You can enable the new PayPal Payments and PayPal Card Payments modules at Configuration () > Apps & Integrations.

If you enabled these modules while using the Beta release of WHMCS 8.9, you must reactivate them before using them with WHMCS 8.9 Release Candidate or later. If you do not do this, you may experience problems.

Learn more…

On-Demand Renewals for Product Addons

On-Demand Renewals now allow early renewals for product addons. When you enable on-demand renewals, clients can renew services in the Client Area before WHMCS generates their next invoice, with no manual action from your staff.

  • You can configure on-demand renewals globally in the Ordering tab at Configuration () > System Settings > General Settings.
  • You can configure on-demand renewals for individual product addons in the Pricing tab at Configuration () > System Settings > Product Addons.

Learn more…

Separated Invoice Viewing and Management

Invoices in the WHMCS Admin Area now default to a view-only mode. This prevents accidental editing while viewing an invoice and gives admins more fine-grained control of staff permissions.

  • This change affects invoices at Billing > Invoices and in a client’s profile’s Invoices tab.
  • Admins can still add payments, resend emails, and perform certain other tasks in view-only mode if they have the related permissions for those tasks.

A new View Invoice permission at Configuration () > System Settings > Administrator Roles grants admins the ability to view, but not alter, existing invoices. Admins who already had the Manage Invoices permission will continue to be able to edit invoices by clicking Manage Invoice while viewing an invoice.

Learn more…

Product Settings

We have moved the product-specific On-Demand Renewals settings at Configuration () > System Settings > Products/Services from the Other tab to the Pricing tab.

Learn more…

Show on Order Form State

Payment gateway modules now support a VisibleDefault metadata parameter that defines the default Show on Order Form setting. This parameter defaults to true for all payment gateway modules.

Learn more…

Updates and Improvements

Duo® Universal Prompt

We have updated our integration with Duo Security to support the new Universal Prompt login process. This change replaces the previous iframe-based experience and implements a simplified interface that continues to support Duo’s wide range of Two-Factor Authentication options.

Duo has announced that support for the previous iframe-based Duo Prompt will end on March 30, 2024.

  • Duo’s support teams will no longer be able to troubleshoot issues with the previous Duo Prompt after this date.
  • We strongly recommend activating Universal Prompt in your Duo admin portal account as soon as you finish upgrading to WHMCS 8.9. If you do not do this, your customers may experience problems due to Duo’s support changes.

Learn more…

Transactions List

We have updated the displayed transaction details at Billing > Transactions List to include additional information and currency codes for some amounts.

Improved Apps & Integrations Experience

We have optimized page performance at Configuration () > Apps & Integrations, allowing you to search for modules faster.

Improved Invoice ID Incrementation

To improve how WHMCS handles incrementing invoice ID numbers, we have updated the following settings in the Invoices tab at Configuration () > System Settings > General Settings:

  • Invoice # Incrementation now has a maximum value of 999.
  • Invoice Starting # now has a maximum value of 499,999,999.
  • The maximum invoice ID number that the system can generate has increased from 2,147,483,647 to 4,294,967,295.

Stripe™ Module API Updates

We have updated the Stripe, Stripe ACH, and Stripe SEPA modules to update the Stripe PHP library and implement other improvements.

Additionally, Stripe ACH and Stripe SEPA now use Stripe’s PaymentIntents API instead of the deprecated Stripe API. Patches are available to make this change on installations that run WHMCS 8.5, 8.6, 8.7, or 8.8.

Learn more…

Enhanced Domain Pricing Validation

The system now validates your PHP configuration’s max_input_vars setting before saving changes at Configuration () > System Settings > Domain Pricing. This helps to prevent MySQL® errors and other issues that low max_input_vars values may cause.

Learn more…

Blesta 5 Support in ImportAssist

The ImportAssist addon module now supports importing data from Blesta 5. This is a direct change to the ImportAssist module and is not specific to WHMCS 8.9.

Learn more…




Plaid Settings in Stripe ACH Module

We have removed support for Plaid from the Stripe ACH payment gateway module. This includes removing the Plaid Client Id, Plaid Secret, and Plaid Environment settings from the module’s configuration.

For Developers

Template Changes

For a list of changed files and a graphical view of the exact changes between WHMCS 8.8.0 and WHMCS 8.9.0, see our GitHub® repositories:

Last modified: June 24, 2024