Quick Start

Install UniPay, connect your UniPay account, and take your first test payment in under 5 minutes.

Before you start: you need a UniPay account. Sign up at merchant.unipay.network if you don't have one yet.

Step 1 — Install the plugin

  1. In your WordPress admin, go to Plugins → Add New Plugin.
  2. Search for UniPay for WooCommerce and click Install Now, then Activate.
    Alternatively, upload the plugin ZIP directly: Plugins → Add New → Upload Plugin.

Step 2 — Get your API credentials

  1. Log in to the UniPay merchant portal.
  2. Go to Settings → Integrations & Plugins.
  3. Click WooCommerce and generate your API key. Copy it — you'll need it in the next step.
  4. Copy your Webhook Secret from the same screen.

Step 3 — Configure the plugin

  1. In WordPress admin, go to WooCommerce → Settings → Payments.
  2. Find UniPay in the list and click Manage.
  3. Check Enable UniPay payments.
  4. Paste your Live API Key and Live Webhook Secret.
  5. Click Test connection — you should see a green "Connected" confirmation.
  6. Click Save changes.

Step 4 — Register your webhook URL

  1. Your webhook URL is shown in the plugin settings. It looks like:
    https://yourstore.com/wc-api/unipay
  2. In the UniPay merchant portal, go to Settings → Integrations & Plugins → WooCommerce and paste this URL into the Webhook URL field.
  3. Back in WordPress, click Send test webhook. You should see "Webhook received" in green.

Step 5 — Take a test payment

  1. Enable Test mode in the plugin settings and save.
  2. Add your Test API Key and Test Webhook Secret from the merchant portal.
  3. Visit your store, add a product to the cart, and proceed to checkout.
  4. Select UniPay as the payment method and place the order.
  5. You'll see the payment QR card. In the merchant portal's test tools, trigger a payment.completed event for this payment ID.
  6. Your order should move to Processing automatically.

Everything working? Turn off Test mode, save, and UniPay is live on your store.

If something's not working

Run the System Status tool: WooCommerce → UniPay Status. It checks your connection, webhook reachability, PHP version, and more — and shows exactly what needs fixing.

If you're still stuck, see the Troubleshooting guide or contact support with your System Status output attached.

← Previous Overview