Secure Pay Configuration

SecurePay is a secure credit card payment gateway that allows your customers to pay directly on your website. This guide will walk you through configuring SecurePay in WebCommander.

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
• Test credentials for testing before going live

Accessing Payment Gateway Settings

Before you can configure SecurePay, you'll need to install the plugin from the WebCommander Marketplace.

1. Log in to your Webcommander admin panel
2. Navigate to Settings from the left sidebar
3. Click on Payment Gateway from the settings dashboard
4. Find Credit Card in the payment methods list
5. Click the Edit button (three-dot menu) next to Credit Card

General Configuration

Once you're in the Credit Card configuration page, you'll see the General tab. Here's what each setting means:

Make Credit Card as Default Gateway

Check this box if you want SecurePay to be your primary payment method at checkout.

Credit Card Processor

Select SecurePay from the dropdown menu. This tells WebCommander which payment processor to use.

Mode

Select Test for testing or Live for production. Always start with Test mode.

Merchant Code

Enter your unique Merchant Code provided by SecurePay. This identifies your business in the SecurePay system.

Client ID

Enter your SecurePay Client ID here. You'll receive this credential when you sign up with SecurePay.

Client Secret

Enter your SecurePay Client Secret. This is a confidential key provided by SecurePay to authenticate your store.

🔒 Important: Keep your Client Secret confidential and never share it 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

You can also search for and select specific zones if you've created custom shipping or payment zones.

Additional Settings

Information

Use this text area to add any special instructions or information about SecurePay payments for your customers. This message will be displayed during checkout.

Example:

"Your payment will be processed securely through SecurePay. All major credit and debit cards are accepted."

Visibility

Control who can see SecurePay as a payment option:

• Everyone can see – All customers will see SecurePay as an option
• Customers – Only logged-in customers can use SecurePay
• Selected Customer – Only specific customers you choose can use SecurePay

Surcharge Type

Add an additional fee for SecurePay transactions if needed. This helps offset SecurePay's transaction fees:

• No Surcharge – No additional fee
• Flat Surcharge – Add a fixed amount (e.g., $0.30)
• Percent Surcharge – Add a percentage of the order total (e.g., 3%)
• Surcharge On Amount Range – Apply different surcharges based on order value

Flat Surcharge

If you select Flat Surcharge, enter the fixed amount to add to each SecurePay transaction.

Example: If you enter 0.50, customers will pay an extra $0.50 when choosing SecurePay.

Percent Surcharge

If you select Percent Surcharge, enter the percentage to add.

Example: If you enter 2.9, customers will pay an extra 2.9% of their order total.

Surcharge On Amount Range

This advanced option lets you set different surcharge rates based on the order value. You'll need to click Add Surcharge to define your ranges.

Pending Message Configuration

SecurePay transactions may sometimes require additional time to process. You can customize the message customers see while their payment is being confirmed.

How to Set a Pending Message

1. Navigate to the Messages section
2. Click on the Pending Message tab
3. Enter your custom message in the text editor

Example Custom Message:

"Your payment is being processed by SecurePay. You'll receive a confirmation email once the payment is complete. This usually takes just a few minutes."

Formatting Tips:

• Keep the message clear and reassuring
• Let customers know what to expect next
• Include an estimated timeframe if possible
• Avoid technical jargon

Testing Your Setup

Before accepting real payments, thoroughly test your SecurePay integration:

Step 1: Enable Test Mode

1. Set Mode to Test
2. Enter your SecurePay test credentials
3. Click Save

Step 2: Make a Test Purchase

1. Visit your store's front end
2. Add a product to your cart
3. Proceed to checkout
4. Select Credit Card as your payment method
5. Use SecurePay's test card numbers to complete the purchase

Step 3: Verify the Transaction

1. Check if the order appears in your WebCommander orders
2. Verify the order status is correct
3. Confirm the payment details are accurate

Step 4: Go Live

Once testing is successful:

1. Change Mode to Live
2. Update with your live SecurePay credentials
3. Click Save
4. Make a small real purchase to confirm everything works

Common Issues and Solutions

Credit Card Option Not Showing at Checkout

Possible causes:

• Zone settings are restricting availability
• Visibility is set to specific customers only
• Credit Card payment method is disabled

Solution:

1. Check your Zone settings and set to "Any Zone" for testing
2. Ensure Visibility is set to "Everyone can see"
3. Verify Credit Card is enabled in Payment Gateway settings

Payment Failing in Test Mode

Possible causes:

• Incorrect test credentials
• Not using valid test card numbers
• Mode not properly set to Test

Solution:

1. Double-check your test credentials in the SecurePay merchant portal
2. Ensure you're using SecurePay's approved test card numbers
3. Verify Mode is set to Test

Payment Failing in Live Mode

Possible causes:

• Mode not switched to Live
• Incorrect live credentials
• SecurePay account not fully activated

Solution:

1. Confirm Mode is set to Live
2. Verify your live credentials are entered correctly
3. Check that your SecurePay account is fully activated for live transactions

Best Practices

Security

• Never share your API password or store it in insecure locations
• Use strong passwords for your SecurePay account
• Enable two-factor authentication on your SecurePay account if available
• Regularly review your SecurePay transaction history

Customer Experience

• Set clear expectations about the payment process
• Use the Information field to explain the payment method
• Keep your pending messages friendly and informative
• Test the checkout process regularly from a customer's perspective

Business Operations

• Reconcile SecurePay transactions with your WebCommander orders regularly
• Monitor the SecurePay merchant portal for transaction updates
• Keep track of any transaction fees in your pricing
• Update credentials immediately if they change