Why LiqPay belongs in every Ukrainian WooCommerce store
Ukrainian shoppers expect to pay with Privat24, ПриватБанк cards, and Apple Pay at checkout. Stores that rely on manual bank transfers or generic Stripe redirects lose 15–25% of orders at the payment step. Integrating LiqPay directly into WooCommerce closes that gap — and it takes under three business days to deploy.
What you get from a native LiqPay integration
A properly built LiqPay WooCommerce gateway delivers:
- Card payments, Privat24, Apple Pay, and Google Pay — in one checkout flow
- Automatic order status updates on payment success, failure, or refund
- Sandbox testing before every production release
- HMAC-SHA1 signed server-to-server callbacks — no polling, no delays
How we build it at MaxiMoruM
We extend the native WC_Payment_Gateway class in PHP and connect the official LiqPay PHP SDK via Composer. The integration has four working parts.
1. API credentials
Register a merchant account at liqpay.ua and collect your public_key and private_key. Store them in wp-config.php as PHP constants — never in the database or version control.
2. Gateway class
Extend WC_Payment_Gateway and override process_payment(). Build the LiqPay request array — amount, currency, description, order_id — and base64-encode the JSON payload. Sign it with SHA1( private_key . data . private_key ) and redirect to the LiqPay hosted page.
3. Callback handler
Register a WooCommerce API endpoint (?wc-api=liqpay_callback). Receive the POST from LiqPay's servers, verify the HMAC signature, decode the payload, and call $order->payment_complete() or $order->update_status('failed') based on the returned status.
4. QA in sandbox
Run a full payment cycle in LiqPay sandbox mode — success, failure, and chargeback — before pointing the gateway at production. We document every status code and verify inventory deduction end-to-end.
Typical business results
Stores that eliminate external-redirect friction at checkout report a 12–18% improvement in completed orders. LiqPay covers roughly 50% of Ukrainian cardholders through Privat24 — reaching that audience on day one matters for revenue.
Timeline and scope
A standard LiqPay WooCommerce integration takes 2–3 business days: one day for development, one for QA, one for staging and production deployment. Existing WordPress installations require no structural changes.
MaxiMoruM has built payment integrations for Ukrainian e-commerce clients since 2004. If you need LiqPay running on your WooCommerce store, contact us at maximorum.com.
]]>