Case study · WordPress plugin

VitaliiHura
Checkout for LiqPay

I wrote and released my own free plugin in the WordPress.org directory that lets a WooCommerce store accept payments through LiqPay: by card, Apple Pay, Google Pay and Privat24. After payment the order marks itself as paid, and if LiqPay's notification gets lost, the plugin checks the status on its own. I covered the whole path: code and automated tests, refunds from the order, the directory team's review and launch in a live store.

What the site looks like

Plugin settings screen in the WordPress admin, split into sections with a notice at the top
Mobile version: Settings screen

The task

LiqPay from PrivatBank is the choice of many Ukrainian stores, but ready-made WooCommerce modules often let you down exactly where it costs money. On one project the free module did not accept payment confirmations from LiqPay, because that feature was only in the paid version. Paid orders sat on pending and were canceled on their own after a while. The Vydna store needed payments it could trust, working with the new checkout page. I wrote my own plugin and released it for free so that any store can use it.

What was built

  • Orders close on their ownAfter payment, LiqPay sends the store a notification. The plugin checks its signature against the store's secret key, so a payment can't be faked, and marks the order as paid right away. A repeated notification doesn't change the order a second time.
  • If a notification gets lostWhen the buyer comes back to the store after paying, the plugin asks LiqPay for the payment status itself. If the buyer closed the tab, unpaid orders are checked once an hour, and the order page has a button to refresh the status.
  • Each payment goes to the right orderA payment counts only if the currency and amount match the order, and a test payment can't close a real order. Automated tests cover these cases, as well as reading the order number with any prefix.
  • Refunds right from the orderA full or partial refund is a button in the WooCommerce order, with no need to sign in to the LiqPay account. The order shows how much was charged, what fee LiqPay took and how much was refunded to the buyer.
  • New and classic checkoutThe plugin works with both the block checkout page, which new stores get by default, and the classic one. Test mode can be enabled for managers only, so payments can be tested on the live store without buyers seeing it.
  • Multiple languagesThe payment method name, description and payment purpose are set for each site language. The language comes from the order, so a buyer on the English version also sees the English text on their card statement. Works with Polylang, WPML and TranslatePress.
  • Privacy and the directoryWhen a buyer asks for their personal data to be deleted, the plugin erases the masked card number and the bank from the order. Before publication, the plugin passed the WordPress.org directory review and the official automated check with no issues.
  • Orders close on their own

    After payment, LiqPay sends the store a notification. The plugin checks its signature against the store's secret key, so a payment can't be faked, and marks the order as paid right away. A repeated notification doesn't change the order a second time.

  • If a notification gets lost

    When the buyer comes back to the store after paying, the plugin asks LiqPay for the payment status itself. If the buyer closed the tab, unpaid orders are checked once an hour, and the order page has a button to refresh the status.

  • Each payment goes to the right order

    A payment counts only if the currency and amount match the order, and a test payment can't close a real order. Automated tests cover these cases, as well as reading the order number with any prefix.

  • Refunds right from the order

    A full or partial refund is a button in the WooCommerce order, with no need to sign in to the LiqPay account. The order shows how much was charged, what fee LiqPay took and how much was refunded to the buyer.

  • New and classic checkout

    The plugin works with both the block checkout page, which new stores get by default, and the classic one. Test mode can be enabled for managers only, so payments can be tested on the live store without buyers seeing it.

  • Multiple languages

    The payment method name, description and payment purpose are set for each site language. The language comes from the order, so a buyer on the English version also sees the English text on their card statement. Works with Polylang, WPML and TranslatePress.

  • Privacy and the directory

    When a buyer asks for their personal data to be deleted, the plugin erases the masked card number and the bank from the order. Before publication, the plugin passed the WordPress.org directory review and the official automated check with no issues.

Result

The plugin is published in the WordPress.org directory, it has already been downloaded more than 240 times, and any WooCommerce store can install it for free from the admin. In the Vydna store it accepts payments on the live domain, and order closing has been checked with a real payment. I am preparing plugins for monobank and WayForPay on the same pattern. The plugin is independent, and neither LiqPay nor PrivatBank released it.

Start a project

Need a custom plugin
for WordPress?

Leave your email and a few words about your project, and I'll get back to you.

Vitalii Hura, full-stack developer

Vitalii Hura · UkraineOnline until 2 PM New York time and the full EU workday.

A spec, a diagram or screenshots. PDF, images, Word, Excel, up to 20 MB
Got it, thank you. I will reply to within a few hours on working days. A confirmation is on its way. If it is not in your inbox, check your Spam folder.
Reply within a few hours Price agreed upfront Direct or via Upwork

Prefer chat? Message me on Telegram or hire me on Upwork.