Installation Guide

The full walkthrough, with every Shopify screen named. If you want the short version, use the Quick Start.

Before you begin

  • An active Shopify store where you can reach Settings, Payments and Settings, Apps and sales channels
  • Your Shopify store currency set to AUD. UniPay is AUD only.
  • A UniPay merchant account. Create one here if you do not have one.

You will not find UniPay in the Shopify App Store. It is a manual payment method plus a custom app you create yourself, which is why there is no gateway approval to wait for.

Part A. Add the payment method

This is what your customers will choose at checkout.

  1. In your Shopify admin, open Settings, then Payments.
  2. Scroll to Manual payment methods and click Add manual payment method, then Create custom payment method.
  3. In Custom payment method name, enter exactly:
Pay with UniCash

UniPay finds your orders by this name, so it has to match exactly. Your UniPay dashboard shows the same string with a copy button.

  1. In Additional details, paste the buyer instructions from your UniPay dashboard. They read like this, with your own handle filled in:
Pay with UniCash. 1. Open your UniCash app and tap Send. 2. Send to @yourhandle. 3. Enter your order number as the payment note. Your order is confirmed automatically once your payment is received.
  1. Click Activate.

Part B. Connect your store

This is what lets UniPay mark orders paid for you. Without it, the payment method still works, but you would have to mark every order paid by hand.

  1. In your Shopify admin, open Settings, then Apps and sales channels, then click Develop apps.
  2. Click Create an app. Give it a name such as UniPay and click Create app.
  3. Click Configure Admin API scopes and tick exactly these two:
read_orders write_orders

UniPay asks for nothing else. It reads your pending orders and marks matched ones paid.

  1. Click Save.
  2. Open the API credentials tab, click Install app, then confirm with Install.
  3. Click Reveal token once, and copy the Admin API access token. It begins with shpat_.

Shopify reveals that token exactly once. If you navigate away without copying it, delete the custom app and create it again.

  1. In your UniPay dashboard, open Settings, Integrations and Plugins, Online store, choose Shopify, and paste your store address and token.
  2. Click Connect store.

UniPay verifies the token immediately. If the store address or token is wrong, you are told straight away rather than at the first order.

Run a test order

  1. Place an order on your own store and select Pay with UniCash.
  2. Pay from the UniCash app, sending to your handle with the order number as the payment note.
  3. Watch the order in your UniPay dashboard. It should move from Awaiting payment to Paid within about 90 seconds, and Shopify should show the order as paid.

If it does not, see Troubleshooting.