Settings Reference
Every setting in the UniPay plugin explained. Find the settings at WooCommerce → Settings → Payments → UniPay → Manage.
General
Enable/Disable
Toggles whether UniPay appears as a payment option at checkout. Disable this if you need to temporarily hide UniPay without losing your configuration.
Payment method title
The name shown to customers at checkout. Default: UniPay. You can customise this — for example "Pay with UniPay" — but keep it short and clear.
Description
A short line of text shown under the payment method title at checkout. Default: "Pay instantly with UniPay — no card fees, no surcharges."
Test mode
Enable test mode
When enabled, the plugin uses your Test API Key and Test Webhook Secret instead of the live credentials. No real payments are processed. A visible amber notice is shown to customers at checkout warning that the store is in test mode.
Always test with test mode before going live. When you're satisfied, disable test mode and save.
Important: test mode uses a separate payment environment. Test payments will not appear in your live merchant portal transaction history, and live payments will not appear in the test environment.
API Credentials
Get your credentials from the UniPay merchant portal under Settings → Integrations & Plugins → WooCommerce.
Live API Key
Your live API key. Used when test mode is disabled. Stored encrypted in your WordPress database. Never share this key publicly.
Live Webhook Secret
The secret used to verify that webhook events genuinely come from UniPay. Stored encrypted. If you regenerate your webhook secret in the merchant portal, update it here too — mismatched secrets will cause all webhook verification to fail and orders won't auto-confirm.
Test API Key
Your test environment API key. Used only when test mode is enabled.
Test Webhook Secret
Your test environment webhook secret. Used only when test mode is enabled.
Test connection button
Calls the UniPay API with your current credentials and confirms they are valid and the account is active. Run this after entering or changing your API key.
Current rate
Shows the live effective exchange rate applied to orders in your store's currency — for example, 1 UNC = AUD 1.0000. This is the rate your customers will be quoted at checkout. It refreshes each time the settings page loads.
The rate already includes any FX margin applied to your merchant tier. This is the single number you need to understand your effective cost.
Webhook
Webhook URL
Your store's webhook endpoint. Copy this URL and paste it into the UniPay merchant portal under Settings → Integrations & Plugins → WooCommerce → Webhook URL.
Format: https://yourstore.com/wc-api/unipay
HTTPS required. The webhook URL must be on an HTTPS domain. HTTP webhook endpoints will be rejected by UniPay.
Send test webhook button
Sends a test payment.confirmed event to your webhook URL and verifies that the signature check passes. Run this after setting up or changing your webhook URL to confirm end-to-end connectivity.
Help & Support
Quick links:
- System Status — runs diagnostics and shows the health of your UniPay integration. Generate a report to attach to support tickets.
- Documentation — links to this docs site.
- Get help — opens the UniPay support channel.
Advanced
Debug logging
When enabled, the plugin writes detailed logs of all API requests, webhook events, and order status changes to the WooCommerce log system. View logs at WooCommerce → Status → Logs — look for entries starting with unipay-for-woocommerce.
Enable this when diagnosing an issue. Disable it in normal operation — logs can grow large on busy stores.