8.9 Release Notes
Download Now or go to Utilities > Update WHMCS
Release Highlights
WHMCS 8.9 introduced new PayPal® payment gateway modules, extended on-demand renewals to allow early renewals for product addons, and separated admin abilities to view and manage invoices.
Version History
| Latest Update | Version | Release Type |
|---|---|---|
| 03-06-2024 | 8.9.0 | General Availability |
| 02-07-2024 | 8.9.0 | Release Candidate |
| 12-06-2023 | 8.9.0 | Beta |
Upgrade Requirements
Before upgrading to this WHMCS version, make certain that your system meets the following requirements:
| Dependency | Minimum Requirement | Recommended |
|---|---|---|
| ionCube® Loader | ionCube Loader 10.2.0 | ionCube Loader 12.0.1 |
| MySQL® | MySQL 5.2 | MySQL 8.0 |
| PHP | PHP 7.2 | PHP 8.1 |
- 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, China, The Republic of Cyprus, Czech Republic, Germany, Denmark, Estonia, Spain, Finland, France, Greece, Hong Kong, Hungary, Italy, Japan, Lithuania, Luxembourg, Latvia, Malta, Netherland, Poland, Portugal, Romania, Singapore, Slovenia, Slovakia, and Sweden.
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.
You can enable the new PayPal Payments and PayPal Card Payments modules at Configuration () > Apps & Integrations.
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.
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.
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.
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.
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.
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,647to4,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.
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.
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.
Deprecations
None
Removals
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: October 30, 2024