Popis
PayBridgeNP for WooCommerce lets your store accept payments through the most popular Nepali
digital wallets and payment methods without writing a single line of code.
Supported payment methods
- eSewa
- Khalti
- Fonepay
Customers choose their preferred method on a branded, mobile-friendly checkout page hosted by
PayBridgeNP. Your store never handles raw payment credentials.
Features
- One-time setup: enter your PayBridgeNP secret key and you’re live
- Sandbox mode: use test API keys for safe development and QA
- Webhook support: reliable order updates via signed server-to-server callbacks
- HMAC-SHA256 signature verification on all webhooks
- HPOS (High-Performance Order Storage) compatible
- Block checkout compatible: works with both the classic shortcode checkout and the modern WooCommerce Blocks checkout
- Works with any WordPress permalink structure
How it works
- Customer places an order and selects PayBridgeNP at checkout
- They are redirected to the PayBridgeNP hosted payment page where they pick a wallet
- After payment they return to your store’s order-received page; the order is set to On Hold immediately
- A signed
payment.succeededwebhook from PayBridgeNP confirms the payment server-to-server and moves the order to Processing
The webhook is what provides authoritative confirmation. Without it, orders stay On Hold indefinitely.
Instalace
From ZIP (recommended)
- Download the latest
paybridge-np-woocommerce.zipfrom the releases page - In your WordPress admin go to Plugins Add New Upload Plugin
- Upload the ZIP and click Install Now, then Activate
- Go to WooCommerce Settings Payments and enable PayBridgeNP
- Enter your secret key and (optionally) your webhook signing secret
From source (developers)
- Clone or copy the
packages/woocommercedirectory intowp-content/plugins/paybridge-np-woocommerce - Run
composer install --no-devinside the plugin directory - Activate the plugin in WordPress admin and follow steps 4-5 above
Webhook setup (required for orders to reach Processing)
- In your PayBridgeNP dashboard go to Webhooks Add endpoint
- Set the URL to:
https://yourstore.com/?wc-api=paybridge_webhook - Subscribe to:
payment.succeeded,payment.failed,payment.cancelled - Copy the signing secret and paste it into the Webhook Signing Secret field in WooCommerce settings
Local development webhook testing
PayBridgeNP needs a publicly reachable URL to deliver webhooks. Use a tunnel tool to expose your local server:
`bash
ngrok http 80
`
Then use the generated https://xxx.ngrok.io/paynep/?wc-api=paybridge_webhook as your webhook endpoint URL in the dashboard.
Nejčastější dotazy
-
What currency does this gateway support?
-
Your WooCommerce store currency must be set to NPR (Nepalese Rupee).
-
Do I need a PayBridgeNP account?
-
Yes. Sign up at paybridgenp.com to get your API keys.
-
Is sandbox/test mode available?
-
Yes. Create a sandbox project in your PayBridgeNP dashboard, use the
sk_test_key, and all
payments will go through the eSewa/Khalti sandbox environments. -
What happens if the webhook is not configured?
-
Orders will still be created and marked On Hold when the customer returns from payment.
Without a webhook the order will not automatically move to Processing. Webhooks are strongly
recommended for a reliable store experience. -
Is this plugin compatible with the WooCommerce block checkout?
-
Yes. PayBridgeNP works with both the classic shortcode checkout and the modern WooCommerce Blocks checkout out of the box.
Recenze
Pro tento plugin nejsou žádné recenze.
Autoři
PayBridgeNP for WooCommerce je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPřeložte “PayBridgeNP for WooCommerce” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
1.1.1
- Rename gateway classes and the icon filter to use a consistent
Paybridge_WC/paybridge_wc_prefix, matching the existingPAYBRIDGE_WC_*constants (WordPress.org plugin guidelines on unique prefixes)
1.1.0
- Bundle the latest PayBridgeNP PHP SDK (3.0.0) with the new typed exception hierarchy and nested error envelope handling
- Errors thrown from PayBridgeNP API calls are now typed exceptions (AuthenticationException, AccountException, PermissionException, InvalidRequestException, IdempotencyException, RateLimitException) — branch with instanceof in custom integrations
- Every exception now carries getErrorType(), getErrorCode(), and getRequestId() — quote getRequestId() in support requests for fastest triage
- Backward compatible: the SDK still parses the legacy flat error shape during the API transition window
1.0.1
- Add
Requires Plugins: woocommerceheader so WordPress 6.5+ enforces the WooCommerce dependency at activation - Bundle the latest PayBridgeNP PHP SDK (2.0.0)
1.0.0
- Initial release
- eSewa, Khalti, and Fonepay support via PayBridgeNP hosted checkout
- Classic shortcode checkout and WooCommerce Blocks checkout support
- Webhook handler with HMAC-SHA256 signature verification (signing secret required)
- HPOS compatible
