Baza Payment Gateway for LiqPay

By Baza Developers

10+ active installationsVersion 2.1.0

Accept LiqPay payments anywhere on your site — no shop or cart needed. Shortcode, block and Elementor widget, payment history, refunds, test mode.

Description

Baza Payment Gateway for LiqPay lets you accept LiqPay payments anywhere on your site, with no WooCommerce and no cart. Add a payment button or form with a shortcode, a Gutenberg block or an Elementor widget, enter your LiqPay keys, and you are ready to take payments in a few minutes.

Good for: donations, paid services and consultations, course or event fees, invoices, prepayments, and any “pay this amount” page.

New in 2.1: permanent payment history, CSV export, one-click refunds, test mode, a connection check for your keys, and a choice of payment methods.

Main Features:

Payment Integration:
* Payment history, CSV export and refunds – manage payments without leaving WordPress
* Test mode and connection check – verify your keys before going live
* Secure LiqPay integration – full connection with the payment system
* Multiple currencies – supports UAH, USD, EUR
* Order management – automatic order ID generation and tracking
* Payment status tracking – real-time monitoring via WP Cron
* Dynamic pricing – fetch prices from WordPress meta fields

Visual Customization:
* Customizable buttons – full control over payment button styles
* Form design – flexible form container styling
* Color control – integration with the site color palette
* Responsive design – works perfectly on all devices
* Live preview – see styling changes in real time in admin

Builder Support:
* Gutenberg block – native integration with WordPress block editor
* Elementor widget – full support for Elementor page builder
* Shortcode support – classic shortcode functionality
* Universal template – consistent rendering across all platforms

Smart Notifications:
* Email alerts – automatic email notifications about payment events
* Telegram integration – real-time Telegram notifications
* Multilingual support – Ukrainian and English translations
* Smart delivery – prevents duplicate alerts on page reload
* Localized statuses – translated payment status messages

Security & Settings:
* AES-256 data encryption – all API keys stored securely
* Automatic saving – AJAX-based autosave for settings
* Real-time validation – instant data correctness checks
* Duplicate protection – smart system preventing repeated notifications
* Custom thank-you page – configurable redirect page after payment

Supported Payment Methods:

  • Visa / MasterCard
  • Privat24
  • Google Pay / Apple Pay
  • All other LiqPay payment methods

Technical Features:

  • Data encryption – AES-256-CBC used to protect API keys
  • AJAX autosave – saves changes instantly without page reload
  • Real-time validation – validates entered data immediately
  • Automatic callbacks – handles LiqPay notifications
  • WP Cron monitoring – automated payment status checking
  • Telegram Bot API – Telegram integration for notifications
  • Transient system – temporary storage for payment data
  • Multilingual alerts – localized notification messages

Usage Methods:

1. Shortcode:
[baza_liqpay amount="2000" description="Оплата товару" button_text="Сплатити зараз"]

Also supported (legacy alias):
[baza_payment_gateway_liqpay amount="2000" description="Оплата товару" button_text="Сплатити зараз"]

Shortcode Parameters:
* amount – payment amount
* description – payment description
* button_text – button text
* currency – currency (UAH, USD, EUR)
* language – interface language: uk (Ukrainian) or en (English)
* order_id – your own reference, e.g. an invoice number (optional). Letters, digits, - and _, up to 30 characters. It is used as the start of the LiqPay order ID, followed by a unique suffix, e.g. INV-125_1731772800_4821
* layout – widget design: box (full form, default) or button (button only)
* custom_amount – allow visitor to enter their own amount: yes or no
* show_currency_select – show currency dropdown in custom amount mode: yes or no

2. Gutenberg Block:
Find the “Baza LiqPay” block in the “Widgets” category and add it to your page.

3. Elementor Widget:
Drag the “Baza LiqPay” widget from the “Baza Widgets” section.

4. Meta Field Price:
Configure the “Price Meta Field” option to automatically fetch the price from the current page/post meta field.

Notification Setup:

Email Notifications:
Automatically sent to the admin email when the payment status changes.

Telegram Notifications:
1. Create a bot using @BotFather
2. Get your bot API key
3. Find your Chat ID
4. Enter the data in the plugin settings

Payment Statuses:
* Processing – payment initialized
* Success – payment completed successfully
* Failed – payment declined
* Error – an error occurred during processing

Security:

  • All sensitive data is encrypted
  • WordPress nonces used to protect from CSRF attacks
  • Input data validation and sanitization
  • Secure AJAX API for settings saving
  • Protected LiqPay callback URLs

Multilingual:

The plugin is fully translated into:
* Ukrainian
* English

External Services

LiqPay Payment Gateway

This plugin uses LiqPay API (https://www.liqpay.ua/) to process online payments. When users make a payment, the following data is sent to LiqPay servers:
* Payment amount, currency, and description
* Order ID
* Your LiqPay API credentials (public and private keys)
* Callback URLs for payment status updates

LiqPay Documentation: https://www.liqpay.ua/doc

Telegram Bot API (Optional)

If configured, the plugin can send payment notifications via Telegram Bot API (https://telegram.org/). This feature is optional and disabled by default.

When enabled, payment information (order ID, amount, currency, description, status) is sent to Telegram servers using your Bot API key. No data is sent if Telegram integration is not configured.

Telegram Terms of Service: https://telegram.org/tos
Telegram Privacy Policy: https://telegram.org/privacy
Telegram Bot API Documentation: https://core.telegram.org/bots/api

Data stored on your site

The plugin keeps a payment history in its own database table: order ID, amount, currency, description, status, payment method, masked card number (as returned by LiqPay), and timestamps. Card numbers and card holder data never pass through your site: payers enter them on the LiqPay page. You can delete records from the history, and everything is removed when you delete the plugin.

Third-party code:

  • Coloris colour picker (Melloware), MIT license – https://github.com/melloware/coloris – bundled in assets/vendor/coloris/

Additional Info

Developer:

Baza Developers – a leading web studio in Ukraine specializing in high-quality WordPress solutions.

Our Other Plugins:

Baza Booking Calendar – a powerful booking calendar with automatic payments via MonoBank and PrivatBank.

Support:

  • Email: support@bazadevelopers.com
  • Website: https://bazadevelopers.com
  • Documentation: https://bazadevelopers.com/products/liqpay/

Support Development:

  • Rate us 5 stars in the WordPress repository
  • Leave a review about your experience
  • Share the plugin with friends and colleagues
  • Donate: https://www.paypal.com/donate/?business=A9R843N82XG3G&no_recurring=0&currency_code=USD

Minimum Requirements:

  • WordPress 7.0+
  • PHP 7.4+
  • MySQL 5.6+ or MariaDB 10.1+
  • HTTPS (recommended for payments)
  • OpenSSL for encryption

Compatibility:

  • Gutenberg Editor
  • Classic Editor
  • Elementor
  • Popular themes

Installation

Automatic Installation:

  1. Log in to your WordPress admin panel
  2. Go to “Plugins” → “Add New”
  3. Search for Baza Payment Gateway for LiqPay
  4. Click “Install Now”
  5. Activate the plugin

Manual Installation:

  1. Download the plugin archive
  2. Extract the files to /wp-content/plugins/baza-payment-gateway-liqpay/
  3. Activate via the “Plugins” menu in WordPress

Configuration:

  1. After activation, go to “Baza LiqPay” in the admin menu
  2. Enter your LiqPay API keys:
    • Public Key
    • Private Key
  3. (Optional) Configure Telegram notifications:
    • Telegram Bot API Key
    • Telegram Chat ID
  4. Choose default currency and language
  5. Configure the thank-you page (optional)
  6. Set up the price meta field (if needed)
  7. Customize button and form styles
  8. Add the payment form to your site using any method above

Getting LiqPay API Keys:

  1. Register or log in to your LiqPay dashboard
  2. Go to “Settings” → “API”
  3. Copy your Public Key and Private Key
  4. Paste them into the plugin settings

Telegram Setup:

  1. Message @BotFather on Telegram
  2. Create a new bot using /newbot
  3. Copy the bot’s API key
  4. Message @userinfobot to get your Chat ID
  5. Enter the details in the plugin settings

FAQ

Do I need WooCommerce?

No. The plugin works on its own. Put a shortcode, block or Elementor widget on any page.

Is it safe to store API keys in the plugin?

The keys are stored encrypted (AES-256-CBC) and are never printed back into the settings page. The encryption protects against casual exposure such as a leaked database dump, but like any plugin that must use a secret key, it cannot protect against someone who has full access to both your database and your wp-config.php. Use a strong admin password, keep WordPress updated, and rotate the keys in your LiqPay account if you suspect a leak.

Can I test payments without real money?

Yes. Turn on “Test mode” in Settings. Payments go through the LiqPay sandbox and are marked “Test” in the history. Use the “Test connection” button to check your keys first.

Can I refund a payment?

Yes. Open the Sessions tab and click the refund icon on a successful payment. The full amount is returned through LiqPay.

Can I export payments?

Yes. Use “Export CSV” in the payment history. The file opens correctly in Excel and Google Sheets, including Cyrillic text.

Can I choose payment methods?

Yes. In Settings pick any of Card, Privat24, Google Pay, Apple Pay, LiqPay and QR. Leave all unchecked to offer every method enabled in your LiqPay account.

Where are payment data stored?

In a dedicated table in your WordPress database, so history is kept until you delete it. Short-lived flags (such as “notification already sent”) use WordPress transients.

Can I disable notifications?

Telegram is optional: leave the Telegram fields empty. Email notifications go to the site admin email and can be silenced with the wp_mail filter in a small snippet if you do not want them.

Can I use meta fields for price?

Yes. In settings, specify a “Price Meta Field” name. The plugin will fetch the value for the current post/page.

What if I receive duplicate notifications?

The plugin ignores repeated LiqPay callbacks for the same order and status. If you still see duplicates, check your WP Cron configuration on your hosting.

How to configure the thank-you page?

In settings, choose a “Thank You Page”. If none is selected, payers return to the page they paid on.

Does it work with caching?

Payment forms are generated on the page and secured with a signed token that is valid for 24 hours. If you use full-page caching, set the cache lifetime for pages with a payment form to less than 24 hours, and exclude the /baza-liqpay-callback/ URL from caching.

Does it support subscriptions or hold?

Not yet. One-time payments, refunds and payment history are supported.

Screenshots

Changelog

2.1.0 – 2026-11-16

Added:
* Permanent payment history (own database table) with method, card mask and test flag
* CSV export of the payment history
* One-click full refunds from the history table
* Test mode switch (LiqPay sandbox) and “Test connection” button for your keys
* The shortcode order_id attribute now works: it becomes the start of the LiqPay order ID
* Choose which payment methods are offered: card, Privat24, Google Pay, Apple Pay, LiqPay, QR

Improved:
* Save and error messages now use the same animated toast as Baza Helper; tooltips match it too
* Cleaner settings: help text sits under its field, no show/hide buttons on key fields, smaller counters
* One admin notice at a time, with “Remind me later” and “Not interested” on every one; a small, optional donation notice
* Tooltips on every header icon, a styled confirmation dialog for refunds and toast messages instead of browser pop-ups
* New colour picker in the style settings (same as in Baza Booking Calendar): swatch, colour gradient, hex field, light and dark admin themes
* Private key and Telegram key are no longer printed into the settings page; leave the field empty to keep the saved key
* Payment status checks no longer depend on the options table, so they work with Redis/Memcached object cache
* Sessions that were never paid are marked as timed out instead of silently disappearing

2.0.3 – 2026-11-16

Security:
* Payment price tokens now expire (24 hours)
* Rate limit on creating new payment sessions per visitor
* Repeated LiqPay callbacks no longer fire hooks or notifications twice
* The return URL is restricted to the site’s own domain
* Theme preference endpoint now requires an administrator
* Plugin cron events are removed on deactivation; all data is removed on uninstall (new uninstall.php)

2.0.2 – 2026-10-04

  • Fixed the Elementor widget not appearing or losing its settings in current Elementor versions (now registered through elementor/widgets/register, register_controls() and content_template())
  • Fixed the API keys being printed into the block editor’s page source: the editor now only learns whether the keys are set
  • Gutenberg block script now depends on wp-block-editor instead of the deprecated wp-editor
  • Fixed the Gutenberg block appearing unstyled (oversized payment logos, plain text) in the editor: its styles now load inside the editor’s canvas
  • Fixed re-activating the plugin resetting saved API keys and styling to the defaults
  • The plugin’s admin menu icon is always shown at full opacity
  • Tested with WordPress 7.1.2

2.0.1 – 2026-08-08

  • Added baza_liqpay shortcode alias (removed again in 2.1.0; use baza_payment_gateway_liqpay)
  • Added show_currency_select option (global setting + per-instance override via shortcode/block/widget)
  • Fixed duplicate tooltip appearing on payment sessions table auto-refresh
  • Gutenberg block and Elementor widget now expose all display settings (layout, custom amount, currency select visibility) per instance
  • Added baza-liqpay-container-amount CSS class to preview container when custom amount mode is active

2.0.0 – 2026-08-07

  • Redesigned the admin interface with a cleaner, more modern layout
  • Added a new widget design setting, choose between the full form and a single button
  • Added support for custom amount entry, let customers enter their own payment amount
  • Added custom meta field mapping for price and title, turn any post type into a simple storefront
  • Updated screenshots

1.0.6 – 2025-01-26

Added payment transients management class

1.0.5 – 2025-01-25

New Features:
* Telegram notifications – full Telegram Bot API integration for instant alerts
* Automatic payment tracking – WP Cron monitoring through LiqPay API
* Duplicate protection – smart system preventing repeated notifications
* Custom thank-you page – option to select a redirect page
* Meta fields for dynamic pricing – auto fetch prices from WordPress meta fields
* Localized payment statuses – Ukrainian translations for payment statuses
* Improved callback system – reliable LiqPay notification handling

Improvements:
* Optimized notification system with duplicate checking
* Enhanced transient data security
* Extended form styling options
* Improved theme compatibility
* Optimized AJAX performance

Fixes:
* Fixed duplicate notifications on page reload
* Improved callback error handling
* Fixed encoding for Ukrainian symbols in Telegram
* Optimized transient data handling

1.0.0 – 2025-01-24

Initial Release!

Added:
* Modern admin panel with autosave
* AES-256-CBC encryption for API keys
* Shortcode support with flexible parameters
* Gutenberg block with visual editor
* Elementor widget with advanced settings
* Responsive payment form design
* Real-time Telegram notifications
* HTML email templates for alerts
* Automatic payment tracking via WP Cron
* Duplicate notification protection
* Configurable thank-you page
* Meta fields for dynamic prices
* Localized payment status messages
* Multilingual support (UA/EN)
* Secure callback handling
* Real-time validation
* Support for all LiqPay payment methods

Security:
* CSRF protection via WordPress nonces
* Data sanitization and validation
* Secure data storage
* Protected AJAX requests
* Unique callback URLs

Performance:
* Optimized database queries
* Minimal impact on site speed
* Lazy script loading
* Efficient settings caching
* Transient system for temporary data