Appearance
PhonePe setup
Prepare the PhonePe side before WHMCS can take a payment: a PhonePe Business account, a pair of API credentials, and a webhook pointing back at your site.
Prerequisites: access to the PhonePe Merchant (Business) dashboard and your WHMCS admin, with the gateway already activated (Installation).
1. Sign up and complete KYC
Create a PhonePe Business account and complete KYC (identity and business verification). You can explore the dashboard while it's pending, but the account can't accept live payments until KYC is verified.
Do this early
KYC can take time. Start it first so it's finished by the time you're done testing in sandbox.
2. Generate your Client ID and Client Secret
In the Merchant (Business) dashboard, generate your API credentials, then copy them into Setup → Payment Gateways → PhonePe:
| Dashboard value | WHMCS field | Notes |
|---|---|---|
| Client ID | Client ID | Identifies your account |
| Client Secret | Client Secret | Authenticates it — keep private |
| — | Client Version | Leave at the default 1 unless PhonePe says otherwise |
Setup → Payment Gateways → PhonePe → Client ID / Client Secret
Then Save Changes.
3. Configure the webhook
Set the webhook URL in the dashboard's webhook settings (must be reachable over HTTPS):
https://yourdomain.com/modules/gateways/phonepe/webhook.phpChoose a username and password for the webhook in the dashboard.
Match them in WHMCS — enter the exact same values in Webhook Username and Webhook Password, then Save Changes.
Values must match
The webhook is SHA256-authenticated. If the username or password differs between PhonePe and WHMCS, notifications are rejected and invoices won't be marked paid.
4. Test in sandbox
Leave Sandbox Mode on and run a test payment before taking real money. Once it works end to end, follow Going live.
Related pages
- Going live — test then turn Sandbox Mode off
- Webhooks — how the notification is verified
- Configuration — all the gateway fields
- Requirements — server and account prerequisites