PayPal Payment Gateway Setup Guide
PayPal is a globally trusted payment gateway that enables customers to make secure payments using credit cards, debit cards, or their PayPal balance. This guide outlines the steps to configure PayPal in your Webcommander store.
Prerequisites
Before you begin, make sure you have:
- A PayPal Business account
- Your PayPal API credentials (Client ID and Client Secret)
- Access to your Webcommander admin panel
Don’t have a PayPal Business account? You can sign up at paypal.com/business.
Accessing Payment Gateway Settings
- Log in to your Webcommander admin panel.
- Navigate to Settings from the left sidebar.
- Click on Payment Gateway from the settings dashboard.
- Locate PayPal in the list of available payment gateways.
- Click the Edit button (three-dot menu) next to PayPal.
General Configuration
Once you're in the PayPal configuration page, you'll see the General tab. Below is an explanation of each setting:
Make PayPal as Default Gateway: Tick this checkbox if you want PayPal to be the primary payment option for your customers. If enabled, PayPal will be pre-selected at checkout.
Version: Select your PayPal API version (Standard recommended for most users, or Classic for legacy integrations).
Client ID: Enter your PayPal REST API Client ID.
Client Secret: Enter your PayPal REST API Secret Key (keep confidential and never share publicly).
Mode: Choose the environment for your PayPal integration:
- Test – Use this for testing payments without processing real money.
- Live – Use this when you're ready to accept real payments.
Zone: Select the geographical zone where PayPal will be available:
- Any Zone – Available worldwide
- New Zone – Create a custom zone
- REST_OF_THE_WORLD – Available except excluded zones
Information: Add optional checkout instructions for customers (for example: “You'll be redirected to PayPal to complete your secure payment”).
Visibility: Define who can use PayPal by selecting Everyone, Customers, or Selected Customers.
Surcharge Type: Add optional fees to offset PayPal costs. You can choose 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 PayPal transaction (e.g., 0.50 adds $0.50 per order).
- Percent Surcharge: Enter a percentage fee to add to each PayPal 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 Setup
Customise the message customers see while PayPal 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."
Tip: Keep it clear, reassuring, and include expected timeframes.
Testing Your PayPal Integration
- Enable Test Mode: Set Mode to Test, enter Sandbox credentials from developer.paypal.com, and save.
- Make a Test Purchase: Add a product to cart, checkout, select PayPal, and complete purchase with test accounts.
- 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
PayPal Not Showing at Checkout: Ensure the Zone is set to “Any Zone,” Visibility is set to “Everyone,” and PayPal is not listed under “Disabled Payments.”
Payment Stuck on Pending: Log into your PayPal account to check notifications, confirm the customer completed payment, and review the transaction in the PayPal dashboard.
Wrong Credentials Error: Verify the Client ID and Secret in the PayPal Developer Dashboard, ensure the correct mode (Test or Live) is selected, and regenerate credentials if necessary.
Best Practices
Security: Never share your Client Secret, use strong passwords, enable two-factor authentication, and regularly review your transaction history.
Customer Experience: Set clear payment expectations, use the Information field to explain the process, keep pending messages friendly and informative, and test checkout regularly.
Business Operations: Reconcile PayPal transactions with Webcommander orders regularly, enable email notifications, monitor transaction patterns, and account for PayPal fees in your pricing strategy.
