Installation Guide

Full installation walkthrough, including manual installation, updates, and uninstalling cleanly.

Method 1 — WordPress Plugin Directory

1. In WordPress admin, navigate to Plugins → Add New Plugin.
2. Type UniPay for WooCommerce in the search field.
3. Click Install Now on the UniPay plugin card.
4. Once installed, click Activate.
5. You'll be redirected to the Plugins list. UniPay is now active.

Method 2 — Upload ZIP

Use this method if your WordPress admin doesn't have internet access, or if you're installing a specific version.

1. Download the plugin ZIP from unipay.network/woocommerce.
2. In WordPress admin, go to Plugins → Add New Plugin → Upload Plugin.
3. Click Choose File, select the ZIP, and click Install Now.
4. Click Activate Plugin.

Method 3 — Manual FTP/SFTP

1. Download and unzip the plugin file.
2. Upload the unipay-for-woocommerce folder to /wp-content/plugins/ on your server.
3. In WordPress admin, go to Plugins and activate UniPay for WooCommerce.

After activation

Once activated, you'll find UniPay in WooCommerce → Settings → Payments. Complete configuration before enabling the gateway — an unconfigured payment method won't appear at checkout.

See the Quick Start for the full configuration walkthrough, or Settings Reference for detailed explanation of every option.

Hosting provider notes

SiteGround

SiteGround's SuperCacher can interfere with webhook delivery. Exclude your webhook URL from caching: in SiteGround's dashboard, go to Speed → Caching → Dynamic Cache and add /wc-api/unipay to the exclusion list.

WP Engine

WP Engine's built-in cache excludes checkout pages by default, which is correct behaviour. No additional configuration is needed. Ensure your WP Engine plan allows external API requests — some legacy plans restrict outbound connections.

Kinsta

Kinsta's Nginx cache is typically configured to exclude WooCommerce pages. Verify the cache is excluded for /wc-api/* paths in your Kinsta dashboard under Cache → Cache Exclusions.

Cloudways

No specific issues known. If webhooks are not being received, check that Varnish cache is excluded for /wc-api/* in your Cloudways application settings.

Shared hosting (cPanel)

UniPay works on shared hosting provided PHP 8.1+ is available. In cPanel, check MultiPHP Manager to set PHP 8.1 or higher for your domain. Some shared hosts block outbound HTTPS requests — run System Status → Test connection to verify.

Updating the plugin

Updates are delivered automatically through the WordPress plugin system. When a new version is available, you'll see an update notice in Plugins. Click Update Now.

Your API key, webhook secret, and all settings are preserved across updates.

Uninstalling

1. Deactivate the plugin: Plugins → Deactivate. Your settings are kept so reactivation doesn't require reconfiguration.
2. To fully remove: Plugins → Delete. This removes all plugin settings from your database.