Accept Nepali payments on WHMCS with one integration

PayBridgeNP is a payment gateway for Nepal. Install this module once and your customers can pay WHMCS invoices with eSewa, Khalti, Fonepay, and any future method PayBridgeNP adds - no second configuration, no second reconciliation, no duplicate webhook endpoints.

Built specifically for WHMCS hosts and domain resellers in Nepal. GPL-licensed, free to use, source on GitHub.

Why this module

• eSewa, Khalti, and Fonepay in one module. The official Khalti WHMCS module covers only Khalti. Existing eSewa modules cover only eSewa. This module covers all three - customers pick on a hosted checkout page, or you can pin the gateway to a single method.
• Full refund support inside WHMCS admin. Click Refund on a transaction, including partial refunds - the module calls the PayBridgeNP refund API and records the result in both WHMCS and your PayBridgeNP dashboard.
• HMAC-signed webhooks with a 5-minute replay window. Unsigned events are rejected with HTTP 400 - no unsigned fallback that an attacker could exploit for free orders.
• Idempotent payment application via WHMCS's checkCbTransID helper - replayed webhooks never double-post to tblaccounts.
• Gateway Log integration with automatic secret scrubbing. API keys, signing secrets, and signature headers never land in the log - safe to share with support.
• Optional Public Callback URL override for installs behind a load balancer, or when you are testing locally with cloudflared or ngrok.

Requirements

• WHMCS 8.0 or newer (tested up to 8.13)
• PHP 7.4 or newer with the ionCube Loader extension (which WHMCS requires anyway)
• Invoice currency set to NPR (Nepalese Rupee)
• A PayBridgeNP account at dashboard.paybridgenp.com/signup - sign-up is free

Install in 10 minutes

1. Download the ZIP from paybridgenp.com/integrations/whmcs or this Marketplace listing.
2. Extract at the root of your WHMCS install. Files merge into modules/gateways/.
3. In WHMCS admin, activate the gateway from Configuration → System Settings → Payment Gateways → All Payment Gateways → PayBridgeNP.
4. Paste your test or live secret key and webhook signing secret from dashboard.paybridgenp.com. Save.
5. In your PayBridgeNP dashboard, register a webhook pointing at https://your-whmcs-url/modules/gateways/callback/paybridgenp.php. Subscribe to payment.succeeded, payment.failed, and payment.cancelled.

Done. Your customers can now pay WHMCS invoices with eSewa, Khalti, or Fonepay.

A note on recurring billing

PayBridgeNP does not vault cards, because Nepali wallets do not currently support merchant-initiated charges. WHMCS renewal invoices are emailed to customers, who pay them interactively. Everything else - one-off invoices, add-ons, upgrades - works normally.

Support

• Full integration guide: docs.paybridgenp.com/integrations/whmcs
• Troubleshooting: docs.paybridgenp.com/integrations/whmcs/troubleshooting
• Source code: github.com/paybridgenp/whmcs
• Email: [email protected]