描述
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.
安装
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.
常见问题
-
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.
评价
此插件暂无评价。
贡献者及开发者
更新日志
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
