KZ Pay — WooCommerce Payment Integration for Kaspi
Accept Kaspi Pay checkout flows in WooCommerce with a production-ready gateway for Kaspi Public QR API Scheme 1. KZ Pay supports QR payments, mobile payment links, order status polling and secure merchant credential storage.
- Kaspi Public QR API Scheme 1
- WooCommerce Checkout
- KZT stores
What KZ Pay adds to WooCommerce
The module focuses on the payment path that the verified plugin actually supports: Kaspi QR, mobile payment links, status polling and strict order completion checks.
WooCommerce gateway
Adds a dedicated Kaspi payment method to WooCommerce checkout and supports both classic checkout and WooCommerce Checkout Blocks.
QR and payment links
Creates a Kaspi QR token for desktop checkout or a Kaspi payment link for same-device mobile authorization.
Server-side status polling
Tracks provider status from WordPress on a controlled schedule and updates the WooCommerce order when Kaspi returns a final result.
Strict completion checks
Completes orders only after the Processed status is received with a valid transaction and a matching paid amount.
HPOS compatible
Stores payment attempt data through WooCommerce order APIs and declares support for High-Performance Order Storage.
Credential protection
Keeps API credentials server-side and stores sensitive device data encrypted in WordPress options.
A clear payment journey for customers and store teams
The buyer sees the Kaspi payment screen, while the store receives structured order states and support references for follow-up.
-
1
Customer chooses KZ Pay
The WooCommerce order is created as pending and the protected KZ Pay payment page opens.
-
2
Kaspi payment artifact is created
The plugin creates either a QR token or a payment link through Kaspi Public QR API Scheme 1.
-
3
Customer authorizes in Kaspi
Desktop buyers scan the QR code. Mobile buyers can continue through the payment link.
-
4
WooCommerce receives the final state
Polling continues until the payment is processed, expired, failed or requires manual review.
QR checkout
Customer-facing payment page with QR or mobile payment link state.
Order tracking
Order notes and payment attempt status stay connected to the WooCommerce order.
Use KZ Pay when the store matches the payment environment
These requirements come from the actual payment plugin and should stay visible before purchase or implementation.
Platform requirements
- WordPress 6.9 or newer
- WooCommerce 7.0 or newer
- PHP 8.1 or newer on a 64-bit build
- OpenSSL extension enabled
- HTTPS production website
Payment requirements
- WooCommerce store currency set to KZT
- Merchant access to Kaspi Public QR API Scheme 1
- Production Kaspi API key
- Kaspi trade point selected in settings
- Registered payment device token
Supported WooCommerce setup
- Classic checkout
- WooCommerce Checkout Blocks
- High-Performance Order Storage
- One production website per license
- Freemius-managed 7-day no-card trial
Not included
- No Kaspi Shop marketplace integration
- No Scheme 2 or Scheme 3 certificate flow
- No payment webhooks
- No automatic refund API
- Manual refunds are completed in Kaspi Pay and recorded in WooCommerce
KZ Pay for one production website
The subscription includes a site license, product updates and support while the subscription is active. Installed functionality can continue to operate after subscription expiration, but updates and support require an active subscription.
Practical answers before installation
Short answers focused on what the plugin supports today.
Does KZ Pay use payment webhooks?
No. The plugin uses server-side polling through Kaspi status endpoints and completes the WooCommerce order only after a verified Processed status.
Can the store accept currencies other than KZT?
No. The gateway is available only when the WooCommerce currency is set to KZT.
Are refunds automatic?
No. Kaspi Public QR API Scheme 1 does not provide an automatic refund endpoint in this plugin. Refunds are completed in Kaspi Pay and then recorded in WooCommerce.
What happens when the subscription expires?
The installed plugin can continue to run, but updates and support require an active subscription.
KZ Pay is independently developed by Group Starlight and is not affiliated with, endorsed by, sponsored by, or an official product of Kaspi.kz. Kaspi and related trademarks belong to their respective owners.
Ready to connect Kaspi Pay checkout to WooCommerce?
Start with the product page settings, verify the merchant requirements and configure the purchase URL when the production checkout is ready.
Support: starlightkg@gmail.com