---
url: /phonepe-whmcs/guides/phonepe-setup.md
description: >-
  Set up your PhonePe Business account for WHMCS — sign up and complete KYC,
  generate your Client ID and Client Secret, and configure the webhook with
  matching username and password.
---

# 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](/phonepe-whmcs/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.

::: tip 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 |

![PhonePe Client ID and Client Secret fields in WHMCS](/phonepe-whmcs/img/phonepe-whmcs-phonepe-setup-credentials.png)
*Setup → Payment Gateways → PhonePe → Client ID / Client Secret*

Then **Save Changes**.

## 3. Configure the webhook

1. **Set the webhook URL** in the dashboard's webhook settings (must be reachable over HTTPS):

   ```
   https://yourdomain.com/modules/gateways/phonepe/webhook.php
   ```

2. **Choose a username and password** for the webhook in the dashboard.

3. **Match them in WHMCS** — enter the exact same values in **Webhook Username** and **Webhook Password**, then **Save Changes**.

::: warning 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](/phonepe-whmcs/guides/going-live).

## Related pages

* [Going live](/phonepe-whmcs/guides/going-live) — test then turn Sandbox Mode off
* [Webhooks](/phonepe-whmcs/features/webhooks) — how the notification is verified
* [Configuration](/phonepe-whmcs/configuration) — all the gateway fields
* [Requirements](/phonepe-whmcs/requirements) — server and account prerequisites