PayBridgeNP for WooCommerce

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

1. Customer places an order and selects PayBridgeNP at checkout
2. They are redirected to the PayBridgeNP hosted payment page where they pick a wallet
3. After payment they return to your store’s order-received page; the order is set to On Hold immediately
4. A signed payment.succeeded webhook 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.

External services

This plugin connects to the PayBridgeNP payment API to process payments. PayBridgeNP is the
payment service this plugin is built for, and a PayBridgeNP account and API key are required for
the plugin to function.

The plugin contacts the PayBridgeNP API (https://api.paybridgenp.com) in these cases:

• When a customer places an order and chooses PayBridgeNP, the plugin creates a checkout session.
  It sends the order amount and currency, your store’s return and cancel URLs, the WooCommerce
  order id and order key, and the customer’s billing details entered at checkout (name, email,
  phone, and billing address) so the hosted payment page can be pre-filled for the customer.
• When “Provider tiles” display mode is enabled, the plugin requests the list of payment providers
  enabled for your account so it only offers providers you can actually accept. Only your secret
  API key is sent for this request.
• PayBridgeNP sends signed server-to-server webhooks back to your store to confirm payment results.
  The plugin verifies each one with an HMAC-SHA256 signature before updating the order.

No data is sent to any other third party. Payment card and wallet credentials are never handled by
your store; the customer enters them on PayBridgeNP’s hosted page.

Use of the PayBridgeNP service is governed by its terms and privacy policy:

• Terms of Service: https://paybridgenp.com/terms
• Privacy Policy: https://paybridgenp.com/privacy