SecurePay Payment Gateway Setup Guide
SecurePay is a secure credit card payment gateway that allows your customers to pay directly on your website. This guide outlines the steps to configure SecurePay in your WebCommander store.
Prerequisites
Before you begin, make sure you have:
- An active SecurePay merchant account
- Your SecurePay API credentials (Merchant ID and Password)
- Access to your WebCommander admin panel
Don't have a SecurePay account? You can sign up at http://securepay.com.au.
Accessing Payment Gateway Settings
Before you can configure SecurePay, you'll need to install the plugin from the WebCommander Marketplace.
- Log in to your WebCommander admin panel
- Navigate to Settings from the left sidebar
- Click on Payment Gateway from the settings dashboard
- Navigate to Payment Gateway → Credit Card
- Click the Edit button (three-dot menu) next to SecurePay
General Configuration
Once you're in the SecurePay configuration page, you'll see the General tab. Here's what each setting means:
Make SecurePay as Default Gateway: Tick this checkbox if you want SecurePay to be the primary payment option for your customers. If enabled, SecurePay will be pre-selected at checkout.
Mode: Choose the environment for your SecurePay integration:
- Test – Use this for testing payments without processing real money.
- Live – Use this when you're ready to accept real payments.
Merchant Code: Enter your unique Merchant Code provided by SecurePay.
Client ID: Enter your SecurePay Client ID.
Client Secret: Enter your SecurePay Client Secret (keep confidential and never share publicly).
Enable Wallet Payment: Check this box if you want to enable digital wallet payment options for your customers.
Card Logo Type: Choose how credit card logos are displayed at checkout:
- Default – Uses the standard card logos provided by the system
- Custom – Allows you to upload your own custom card logo image
Credit Cards: Simply tick the boxes for the cards you wish to accept.
Zone:Select the geographical zone where PayPal will be available as a payment option:
- Any Zone – PayPal will be available to customers worldwide
- New Zone – Create a custom zone with specific countries
- REST_OF_THE_WORLD – Available in all countries except excluded zones
Information: Add optional checkout instructions for customers (e.g., "You'll be redirected to SecurePay to complete your secure payment").
Visibility: Define who can use SecurePay by selecting Everyone, Customers, or Selected Customers.
Surcharge Type: Add optional fees to offset SecurePay costs: No Surcharge, Flat Surcharge (fixed amount), Percent Surcharge (percentage), or Surcharge On Amount Range (varies by order value).
- Flat Surcharge: Enter a fixed fee amount to add to each SecurePay transaction (e.g., 0.50 adds $0.50 per order).
- Percent Surcharge: Enter a percentage fee to add to each SecurePay transaction (e.g., 2.9 adds 2.9% of the order total).
- Surcharge On Amount Range: Set different surcharge rates based on order value by clicking Add Surcharge to define custom ranges.
Pending Message Configuration
Customize the message customers see while SecurePay processes their payment.
Steps:
- Go to Messages → Pending Message tab
- Enter your custom message
Example: "Your payment is being processed. You'll receive confirmation once complete—usually within a few minutes."
Tips: Keep it clear, reassuring, and include expected timeframes.
Testing Your Setup
- Enable Test Mode – Set Mode to Test, enter Sandbox credentials from SecurePay Developer Portal, and save.
- Make a Test Purchase – Add a product to cart, checkout, select SecurePay, and complete purchase with test credentials.
- Verify Transaction – Check if the order appears in WebCommander with correct status and payment details.
- Go Live – Switch Mode to Live, update with live credentials, save, and test with a small real purchase.
Common Issues and Solutions
SecurePay Not Showing at Checkout: Check Zone is set to "Any Zone," Visibility is "Everyone can see," and SecurePay isn't in "DISABLED PAYMENTS."
Payment Stuck on Pending: Log into SecurePay to check notifications, confirm customer completed payment, and review the transaction in SecurePay dashboard.
Wrong Credentials Error: Verify Client ID and Secret in SecurePay Developer Dashboard, ensure correct mode (Test/Live), and regenerate credentials if needed.
Best Practices
Security – Never share your Client Secret, use strong passwords, enable two-factor authentication, and review transaction history regularly.
Customer Experience – Set clear payment expectations, use the Information field to explain the process, keep pending messages friendly, and test checkout regularly.
Business Operations – Reconcile SecurePay transactions with WebCommander orders regularly, enable email notifications, monitor transaction patterns, and account for SecurePay fees in pricing.
