The mod_liqpay module allows you to integrate the LiqPay payment system into your Joomla 4+ based website.
LiqPay is a widely used Ukrainian payment service that supports multiple payment methods, including bank cards (Visa, MasterCard), Google Pay, Apple Pay, QR-code, and more.
Note:
This module supports Joomla 4.2 and higher, using the new OOP-based module structure introduced in Joomla 4.2.x.
The module includes interface translations for:
- 🇺🇦 Ukrainian (uk-UA)
- 🇬🇧 English (en-GB)
- 🇩🇪 German (de-DE)
- 🇷🇺 Russian (ru-RU)
- Support for UAH, USD, and EUR currencies
- Two operation modes:
- Simple Payment – one-time payment with fixed or preset amounts
- Grouped Payment – structured list of services or items
- Optional donation mode for NGOs or fundraising campaigns
- Built-in test mode for sandbox transactions
- LiqPay callback support for auto status updates
- Email notifications for administrators
- Option to show/hide UI elements: logo, amount, extended info, payment methods
- Logo – image displayed in the module (optional)
- Title – visible name of the module/cause
- Public / Private Key – credentials from LiqPay merchant account
- Module Type – choose between simple or grouped payment
- Currency – default currency (UAH, USD, EUR)
- Allow currency change – optional switch for frontend users
- Payment Type –
pay,donate - Terms URL – optional link to public offer/agreement
- Available Payment Methods – checkboxes for LiqPay, Privat24, Apple Pay, etc.
- Notification Email – address for transaction alerts
- Payment Purpose – description for the transaction
- Default Amount – prefilled value
- Amount Options – list of quick-pick sums (e.g. 100, 200, 500)
- Extra Info – optional rich text (HTML supported)
- Services List – name, description, price, old price, optional flags (e.g. special offer)
- Post-list Text – HTML block after item list
- Joomla 4.2 or newer
- PHP 7.2.5 or higher
- Valid LiqPay merchant account
- Download the latest release from GitHub Releases.
- In Joomla Admin Panel, go to Extensions → Install and upload the module ZIP.
- Navigate to Extensions → Modules, find LiqPay Module, and enable it.
- Open the module configuration and enter your Public and Private keys.
- Select module type, enter payment info, and configure settings as needed.
This module is licensed under the MIT License.
You are free to use, modify, and distribute it in commercial and non-commercial projects.
Preview of the donation/payment form rendered by the module:
Repository: github.com/technoquill/mod_liqpay