WooCommerce is the most widely used e-commerce platform in Nepal. But out of the box, it doesn't support Khalti, eSewa, or ConnectIPS - the three payment methods your Nepali customers actually use.
PayBridgeNP's WooCommerce integration fixes this with a free plugin.
This guide shows you exactly how to set it up in under 10 minutes.
What You'll Need
- A WordPress site with WooCommerce installed
- A PayBridgeNP merchant account (free to create)
- Your Khalti and/or eSewa merchant credentials
Step 1: Install the PayBridgeNP WooCommerce Plugin
The easiest way is from the WordPress plugin directory:
- Go to your WordPress admin panel
- Navigate to Plugins > Add New
- Search for "PayBridgeNP"
- Click Install Now, then Activate
Alternatively, download the plugin from paybridgenp.com/integrations/woocommerce and upload it manually via Plugins > Add New > Upload Plugin.
Step 2: Configure the Plugin
After activation:
- Go to WooCommerce > Settings > Payments
- You'll see PayBridgeNP in the list - click Manage
- Enter your PayBridgeNP API keys (from your dashboard under Settings > API Keys)
- Toggle Enable PayBridgeNP to on
- Set your preferred title (shown at checkout, e.g., "Pay with Khalti / eSewa")
- Save changes
Step 3: Test with Sandbox Mode
Before going live, test the integration:
- In the plugin settings, enable Test Mode
- Replace your live API keys with your sandbox keys
- Place a test order on your store
- Complete the payment using Khalti's or eSewa's test credentials
PayBridgeNP's sandbox gives you instant feedback on each payment event - no waiting for real transactions.
Step 4: Go Live
Once testing looks good:
- Disable Test Mode in the plugin settings
- Replace sandbox keys with your live API keys
- Place a real test order for NPR 10 to confirm everything works end-to-end
How It Works at Checkout
When a customer reaches your WooCommerce checkout and selects PayBridgeNP:
- They click Place Order
- They're redirected to a PayBridgeNP-hosted checkout page showing Khalti, eSewa, and ConnectIPS options
- They pick their provider and complete payment
- They're redirected back to your WooCommerce order confirmation page
- The order status updates to Processing automatically
Order Management
The plugin automatically:
- Updates order status when payment is completed
- Marks orders as Failed if payment fails or expires
- Stores the PayBridgeNP payment ID in the order metadata
- Supports WooCommerce order notes for payment events
Refunds
You can process refunds directly from WooCommerce:
- Open the order
- Click Refund
- Enter the amount
- Click Refund via PayBridgeNP
The refund is processed back to the customer's original payment method (Khalti wallet, eSewa wallet, or bank account).
Troubleshooting
Orders not updating after payment:
Check that your PayBridgeNP webhook URL is registered. In your PayBridgeNP dashboard, go to Developers > Webhooks and add: https://yourstore.com/?wc-api=paybridge_webhook
Plugin not appearing at checkout: Make sure WooCommerce's checkout is using the classic shortcode checkout. Block-based checkout requires the plugin version 1.1+.
Sandbox payments completing but live payments failing: Double-check that you switched API keys from sandbox to live in the plugin settings.
Conclusion
The PayBridgeNP WooCommerce plugin is the fastest way to add Nepali payment options to your store. It's free to install and takes less than 10 minutes to set up. Create your PayBridgeNP account to get your API keys and get started.