Installation Guide

This guide walks you through the full installation of UniPay for Shopify — from the Shopify App Store through to a live test payment.

Before you begin

Make sure you have the following ready:

• An active Shopify store on the Basic plan or above
• Store owner or staff access with Payments permission
• An active UniPay account — create one free at merchant.unipay.network

Install from the Shopify App Store

1. Go to the Shopify App Store and search for UniPay.
2. Open the UniPay — UNC Payments listing and click Add app.
3. You'll be taken to your Shopify admin. Review the list of permissions the app requires, then click Install app.
4. Shopify installs the app and redirects you to the UniPay configuration screen.

Connect your UniPay account

UniPay for Shopify uses OAuth to link directly to your UniPay account. No API keys to copy manually.

1. On the UniPay configuration screen, click Connect to UniPay.
2. You'll be redirected to merchant.unipay.network. Log in with your UniPay merchant credentials.
3. Review the access request and click Authorise.
4. You'll be redirected back to your Shopify admin. Your API key and webhook endpoint are configured automatically.

Enable UniPay as a payment method

1. In your Shopify admin, go to Settings → Payments.
2. Under Additional payment methods, find UniPay.
3. Click Activate UniPay.
4. UniPay appears as a payment option on your store's checkout page.

Configure app settings

After activation, open the UniPay app from your Shopify admin app list to review settings:

• Confirm Test mode is off for live payments (it may be on by default after installation)
• Set the Payment method title shown to customers at checkout — the default is "Pay with UniCash"
• Optionally add a Payment method description

See the Settings Reference for a full description of every option.

Run a test payment

1. Enable Test mode in the UniPay app settings.
2. Open your store, add a product to your cart, and proceed to checkout.
3. Select UniPay (or the title you configured) at the payment step.
4. Scan the test QR code using the UniCash app in test mode.
5. Verify the Shopify order moves to Payment Captured automatically.

After activation

• Turn off test mode before accepting real payments
• Webhook URL is auto-registered — no manual configuration needed in Merchant Portal
• Refunds can be initiated directly from the Shopify order screen — see the Checkout Flow page for details
• Shopify Plus stores can use checkout.liquid customisations — UniPay is fully compatible

Shopify plan notes