Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paybridgenp.com/llms.txt

Use this file to discover all available pages before exploring further.

PayBridgeNP for WHMCS is a first-party payment gateway module that adds a PayBridgeNP method to your WHMCS billing panel. Customers pick it like any other gateway, get redirected to the PayBridgeNP hosted checkout, pay with eSewa or Khalti, and land back on the invoice page - the invoice flips to Paid automatically via a signed webhook.

​
Who this is for

  • You run a WHMCS billing panel (8.0 or newer) for hosting, domains, or any recurring service
  • You want to accept eSewa and Khalti from Nepali customers in one module - no separate integrations to reconcile
  • You already have (or can create) a PayBridgeNP account with a sk_live_… or sk_test_… API key
  • Your invoice currency is NPR

​
What you get

  • eSewa + Khalti in one module. No per-method configuration, no duplicate webhook endpoints. Add any future PayBridgeNP provider without changing the module.
  • Hosted checkout. Customers pay on a mobile-friendly page served by PayBridgeNP. No iframe embedding, no card input inside WHMCS - compliance surface stays small.
  • Full refund support inside WHMCS admin. Click Refund on any transaction, including partial refunds. The module calls the PayBridgeNP refund API and the result flows back into the WHMCS Gateway Log.
  • HMAC-signed webhooks. Every payment.succeeded / payment.failed / payment.cancelled event is verified against an HMAC-SHA256 signature with a 5-minute replay window. Forged events are rejected with a 400 response.
  • Idempotent payment application. Uses WHMCS’s checkCbTransID helper so replayed webhooks never double-post to tblaccounts.
  • Gateway Log integration. Every API call, webhook delivery, and refund attempt is recorded in Utilities → Logs → Gateway Log with request/response context. API keys and signatures are automatically scrubbed before they land in the log - safe to share with support.
  • Public Callback URL override. Optional field for installs behind a load balancer where the WHMCS System URL isn’t internet-reachable, or for local dev with a tunnel (cloudflared / ngrok).
  • GPL-2.0-or-later licensed. Same license family as WHMCS itself.

​
How it plugs in

┌────────────────┐  1. pays invoice (picks PayBridgeNP)    ┌───────────────┐
│   Customer     │ ───────────────────────────────────────▶│     WHMCS     │
└────────────────┘                                         └──────┬────────┘
                                                                  │ 2. paybridgenp_link()
                                                                  │    creates checkout session
                                                                  ▼
                                                         ┌──────────────────┐
                                                         │  PayBridgeNP     │
                                                         │  hosted checkout │
                                                         └────────┬─────────┘
                                                                  │ 3. customer pays (eSewa / Khalti)
                                                                  ▼
┌────────────────┐   5. return URL → invoice view         ┌──────────────────┐
│   Customer     │ ◀───────────────────────────────────── │  callback.php    │
└────────────────┘      (no state mutation here)          └──────┬───────────┘
                                                                  │
                                                                  │ 4. signed webhook (authoritative)
                                                                  ▼
                                                         ┌──────────────────┐
                                                         │  callback.php    │
                                                         │  → invoice Paid  │
                                                         └──────────────────┘

​
WHMCS Marketplace

PayBridgeNP is officially listed on the WHMCS Marketplace at marketplace.whmcs.com/product/8648-paybridgenp. You can install it from there or download directly from paybridgenp.com/integrations/whmcs - the module is identical either way.

​
What’s next