Settings Reference
A full description of every setting in UniPay for Shopify. Access settings from the UniPay app screen in your Shopify admin.
Enable / Disable
| Setting | Description |
|---|---|
| Enable UniPay | Toggles UniPay on or off as a payment method at checkout. When disabled, UniPay does not appear to customers, but your configuration is preserved. |
Display
| Setting | Description |
|---|---|
| Payment method title | The label shown to customers in the payment method list at checkout. Default: Pay with UniCash. Keep it short — Shopify displays this inline with other payment options. |
| Payment method description | Optional short description shown below the payment method title. Leave blank if you prefer a minimal checkout experience. |
API credentials
These fields are populated automatically when you connect via OAuth. You only need to enter them manually if you are configuring the app without the OAuth flow (e.g., via the Shopify Partner Dashboard).
| Setting | Description |
|---|---|
| Live API Key | Your UniPay live API key. Find this in the Merchant Portal under Integrations → Shopify → Live credentials. |
| Live Webhook Secret | Used to verify that incoming webhook events are genuine. Must match the secret shown in Merchant Portal for your Shopify integration. |
| Test API Key | Your UniPay test API key. Used only when Test mode is enabled. Find this in Merchant Portal under Integrations → Shopify → Test credentials. |
| Test Webhook Secret | The webhook secret used when Test mode is enabled. Must match the test secret in Merchant Portal. |
Keep your API key and webhook secret private. Do not share them, commit them to version control, or expose them in client-side code. If either is compromised, regenerate them immediately in the Merchant Portal and update the app settings.
Test mode
| Setting | Description |
|---|---|
| Enable test mode |
When on, the app uses your test API key and test webhook secret. Payments are simulated — no real funds move. A Test mode badge appears in the UniPay payment block at checkout when this is active, so customers cannot accidentally make a real payment. Turn this off before accepting real payments. |
Webhook URL
UniPay sends payment confirmation events to a webhook endpoint on your store. This URL is generated automatically when you install the app — you do not need to configure it manually.
The webhook URL follows the pattern:
https://your-store.myshopify.com/apps/unipay/webhooks/paymentIf you need to register or re-register the webhook manually, go to Merchant Portal → Integrations → Shopify and use the Register webhook button.
Where to find credentials in the Merchant Portal
- Log in at merchant.unipay.network.
- Go to Integrations in the left sidebar.
- Select Shopify.
- Your Live and Test API keys and webhook secrets are shown here. Use the copy button next to each field.