System Requirements
Minimum requirements, tested environments, and known incompatibilities for UniPay for WooCommerce.
Minimum requirements
| Component | Minimum | Notes |
|---|---|---|
| PHP | 8.1 | 8.2 and 8.3 fully tested |
| WordPress | 6.4 | Latest 2 major versions supported |
| WooCommerce | 8.0 | Latest 2 major versions supported |
| HTTPS | Required | Webhooks require SSL; HTTP stores are blocked |
| MySQL / MariaDB | WooCommerce minimum | No additional requirements |
Use the System Status tool (WooCommerce → UniPay Status) to check your environment automatically. It will flag any requirement that isn't met.
Tested environments
| Environment | Status |
|---|---|
| PHP 8.1, 8.2, 8.3 | Tested |
| WordPress 6.4, 6.5, 6.6, 6.7 | Tested |
| WooCommerce 8.x, 9.x | Tested |
| Block checkout (Gutenberg) | Tested |
| Classic checkout (shortcode) | Tested |
| HPOS (High-Performance Order Storage) | Compatible |
| Multisite | Not tested |
Known incompatibilities
These plugins and configurations are known to conflict with UniPay. They are not supported in v1.
WooCommerce Subscriptions
UniPay does not support recurring payments or subscription billing in v1. Subscription orders require customer-initiated payments on a schedule, which is not supported by the current plugin architecture. Merchants with subscription products should use a different gateway for those products.
Multi-vendor plugins (Dokan, WC Vendors)
Multi-vendor plugins split payments between multiple vendors, which is not compatible with UniPay's single-merchant payment model. Not supported in v1.
Currency switcher plugins
Plugins that switch the store's active currency (e.g. WPML WooCommerce Multilingual currency switcher, Currency Switcher for WooCommerce) can interfere with the UNC amount calculation. UniPay detects the store's base currency automatically — currency switching at checkout is not supported.
Cache plugins — checkout exclusion required
Caching the WooCommerce checkout or order confirmation page can break the payment flow. The following cache plugins are known to require configuration:
| Plugin | Action required |
|---|---|
| WP Super Cache | Add /checkout, /order-received, /wc-api/unipay to rejected URIs |
| W3 Total Cache | Add checkout and order pages to the Page Cache exclusion list |
| WP Rocket | WooCommerce pages are excluded automatically — verify in WP Rocket → Advanced Rules |
| LiteSpeed Cache | Enable WooCommerce detection in LiteSpeed → WooCommerce settings |
Custom checkout flows
Heavily customised checkout flows built with page builders (Elementor, Divi, etc.) that replace the WooCommerce checkout template may not display the payment method correctly. Standard block checkout and classic checkout with default templates are fully supported.
Supported currencies
UniPay accepts any currency supported by the UniPay API. For Australian merchants, AUD is native (1 UNC = 1 AUD exactly, no conversion). Other currencies are converted server-side — your store's base currency is detected automatically.
To check if your currency is supported, run System Status → API key validity test — it will confirm your currency is accepted.