Accept Nepali payments on WHMCS with one integration

PayBridgeNP is a payment aggregator for Nepal. Install this module once and your customers can pay WHMCS invoices with eSewa, Khalti, 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 in one module. The official Khalti WHMCS module covers only Khalti. Existing eSewa modules cover only eSewa. This module covers both - customers pick on a hosted checkout page (or you can force 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. The official Khalti WHMCS module stubs refund to return false.
• 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're testing locally with cloudflared / ngrok.

Requirements

• WHMCS 8.0 or newer
• PHP 7.4 or newer with the ionCube Loader extension (which WHMCS requires anyway)
• Invoice currency set to NPR (Nepalese Rupee)
• A PayBridgeNP account (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. 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, payment.cancelled.

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

Support

• Full integration guide: docs.paybridgenp.com/integrations/whmcs
• Troubleshooting: docs.paybridgenp.com/integrations/whmcs/troubleshooting
• Source code: github.com/paybridgenp/whmcs
• Email: support@paybridgenp.com