Official WordPress.org plugin. Search "PayBridgeNP" from your WordPress admin, click Install, paste your API key. Works with every WooCommerce store - classic shortcode checkout, modern Blocks checkout, HPOS, any theme.
A single setting in the plugin decides what your customer sees. Leave it on the default and PayBridgeNP appears once, with the picker hosted by us. Switch it and eSewa, Khalti, and Fonepay sit in the checkout itself, each going straight to that provider.
Plugin setting
Display style
display_style = single_button
Your customer sees
Payment method
One line in the checkout. The customer picks their wallet on the page we host, so your checkout stays short.
Both styles run through the same plugin, the same keys, and the same signed webhooks. Changing it is a dropdown, not a reinstall.
Install
WordPress.org is the fastest path: search, install, activate. If your host blocks the plugin directory, download the ZIP and upload it manually. Both paths ship the same plugin.
GPL-2.0-or-later · v1.3.0 · Source on GitHub
Install the plugin
Search "PayBridgeNP" in Plugins → Add New, or upload the ZIP from this page if your host blocks WordPress.org.
Enable in Payments settings
Open WooCommerce → Settings → Payments, find PayBridgeNP, and toggle Enable. Works with classic shortcode and Blocks checkout.
Connect your API key
Paste your sk_live_ or sk_test_ key and webhook signing secret from the PayBridgeNP dashboard. Save and you're live.
Nothing goes live until you paste your API key and enable the gateway in Payments settings.
How it works
WooCommerce keeps ownership of the cart, shipping, discounts, and customer data. PayBridgeNP handles the wallet redirect and the webhook that flips the order. Everything else on your store stays exactly how you set it up.
Your customer selects PayBridgeNP on the WooCommerce checkout page. Works with classic shortcode checkout and WooCommerce Blocks, no theme changes.
They redirect to eSewa, Khalti, or Fonepay, complete OTP verification, and PayBridgeNP confirms the payment in real time.
A signed webhook hits your store and the order moves from Pending payment to Processing. No spreadsheets, no end-of-day matching.
Features
HPOS-compatible, block-checkout-aware, signature-verified. This isn't a reference implementation - it's the plugin we run on real Nepali stores.
Classic + Block checkout
Works with both the legacy shortcode checkout and the modern WooCommerce Blocks checkout out of the box. No theme changes required.
Permalink-agnostic
Uses WooCommerce's wc-api endpoints which work regardless of your permalink structure. No .htaccess surgery required.
HPOS compatible
Declared compatibility with WooCommerce's High-Performance Order Storage. Runs cleanly on modern WC installs using custom order tables.
Sandbox mode built in
Use a sk_test_ key and eSewa and Khalti run in their sandbox environments, no real money. Fonepay has no sandbox: if you add your own Fonepay credentials to a test project, those QR payments are real and capped at Rs 1,000 each.
Signed webhook verification
Every webhook delivery is verified against an HMAC-SHA256 signature. Unsigned events are rejected - no merchant-side configuration mistakes that open you up to forged payment events.
GPL-2.0-or-later
Same license as WordPress and WooCommerce core. Source code ships inside the plugin ZIP - audit, fork, or modify as you need.
Compatibility
Transparent up front: here's the full compatibility matrix.
| Detail | Support |
|---|---|
| WordPress | 5.8 to 7.0 (tested) |
| WooCommerce | 7.0 to 10.7 (tested) |
| PHP | 7.4 or newer |
| Currency | NPR only |
| Checkout | Classic + Blocks |
| HPOS | Compatible |
| License | GPL-2.0-or-later |
| Distribution | WordPress.org + direct ZIP |
FAQ
Straight answers on WordPress.org, HPOS, checkout types, and refunds.
Yes - the plugin is published on the WordPress.org plugin directory at wordpress.org/plugins/paybridgenp-for-woocommerce. From your WordPress admin, go to Plugins → Add New and search "PayBridgeNP" to install with one click. Auto-updates work through core WordPress. A direct ZIP download is also available from this page if your host blocks WP.org search.
WordPress 5.8 or newer, WooCommerce 7.0 or newer, PHP 7.4 or newer. The plugin is tested up to WordPress 7.0 and WooCommerce 10.7. It declares HPOS (High-Performance Order Storage) compatibility, so it works whether you've enabled HPOS or not.
The plugin is free. PayBridgeNP does not charge a per-transaction fee. Your PayBridgeNP plan and provider fees still apply. No per-order markup or hidden fees.
Your WooCommerce store currency must be set to NPR (Nepalese Rupee). Orders in other currencies will be refused by the gateway. Multi-currency support is on the roadmap.
Not currently. Like the Shopify integration, refunds must be processed from the PayBridgeNP dashboard, which then mirrors back to the WooCommerce order. This is a constraint of redirect-style gateways - the wallet provider (eSewa, Khalti, Fonepay) owns the refund path, not WooCommerce.
Both. The plugin registers itself for both the legacy shortcode checkout and the modern WooCommerce Blocks checkout. You don't have to pick - whichever your theme uses, the gateway appears.
Ready to install
Search "PayBridgeNP" from your WordPress admin, click Install, paste your PayBridgeNP API key, and the gateway appears on your checkout. No developer required.
