---
url: /phonepe-whmcs/configuration.md
description: >-
  Every PhonePe for WHMCS gateway field — Client ID and Secret, Client Version,
  Payment Mode, matching Webhook Username and Password, Sandbox Mode and License
  Key — plus the webhook URL to register with PhonePe.
---

# Configuration

Configure PhonePe on WHMCS's native gateway screen: **Setup → Payment Gateways → PhonePe**. Enter the fields below, then **Save Changes**.

![PhonePe gateway configuration fields](/phonepe-whmcs/img/phonepe-configuration-fields.png)
*Setup → Payment Gateways → PhonePe*

## Fields

| Field | What to enter | Notes |
| --- | --- | --- |
| **Client ID** | Your PhonePe API Client ID from the Merchant (Business) dashboard | Copy exactly — a stray character means PhonePe rejects the connection |
| **Client Secret** | The matching Client Secret | Sensitive; never share or post it |
| **Client Version** | Leave at the default **`1`** | Change only if PhonePe instructs you to |
| **Payment Mode** | **Redirect** (default) or **Iframe** | Redirect = PhonePe's full-page checkout; Iframe = in-page popup. See [Payment modes](/phonepe-whmcs/features/payment-modes) |
| **Webhook Username** | The username you set on the webhook in the PhonePe dashboard | Must match the dashboard exactly |
| **Webhook Password** | The password you set on the webhook in the PhonePe dashboard | Must match the dashboard exactly |
| **Sandbox Mode** | **Yes** = test environment; **No** (default) = live | Confirm a sandbox payment works before switching to live |
| **License Key** | Your PhonePe for WHMCS key from relyweb.co | Validated at payment time; payments are disabled while inactive. See [Licensing](/phonepe-whmcs/licensing) |

Don't have credentials yet? The [PhonePe setup guide](/phonepe-whmcs/guides/phonepe-setup) walks through generating them.

## Register the webhook

PhonePe confirms every payment by webhook. Register this URL in the PhonePe dashboard's webhook settings:

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

Replace `yourdomain.com` with your WHMCS domain, and make sure it's reachable over HTTPS.

::: warning Both sides must match
Matching credentials are required for webhook authentication:

* **Auth failure:** Mismatched **Webhook Username** or **Webhook Password** fails the SHA256 check.
* **Impact:** PhonePe webhooks are rejected and invoices remain unpaid. Set identical credentials in both dashboards.
  :::

## Verify

**Save Changes**, then place a sandbox test order and confirm the invoice is marked **Paid**. If a payment fails, check **Utilities → Logs → Gateway Log** — it records each step of the exchange.

## Related pages

* [Settings reference](/phonepe-whmcs/settings) — every field with defaults
* [Installation](/phonepe-whmcs/installation) — upload, activate, configure
* [PhonePe setup](/phonepe-whmcs/guides/phonepe-setup) — credentials and webhook
* [Payment modes](/phonepe-whmcs/features/payment-modes) — redirect vs iframe
* [Licensing](/phonepe-whmcs/licensing) — how the license types work