---
url: /phonepe-whmcs/settings.md
description: >-
  A field-by-field reference for the PhonePe for WHMCS gateway configuration —
  Client ID and Secret, Client Version, Payment Mode, Webhook Username and
  Password, Sandbox Mode and License Key — with defaults and where activity is
  logged.
---

# Settings reference

Every field on the PhonePe gateway configuration screen (**Setup → Payment Gateways → PhonePe**)
is listed below with its default. For a guided explanation of what each one does, see
[Configuration](/phonepe-whmcs/configuration).

## Gateway fields

| Field | What to enter | Default |
| --- | --- | --- |
| **Client ID** | Your PhonePe API Client ID from the Merchant (Business) dashboard | *(empty)* |
| **Client Secret** | Your PhonePe API Client Secret from the Merchant dashboard | *(empty)* |
| **Client Version** | The API client version — leave as-is unless PhonePe tells you otherwise | **1** |
| **Payment Mode** | `Redirect` (full-page checkout) or `Iframe` (in-page popup) | Redirect |
| **Webhook Username** | Must match the username you set in the PhonePe dashboard webhook | *(empty)* |
| **Webhook Password** | Must match the password you set in the PhonePe dashboard webhook | *(empty)* |
| **Sandbox Mode** | `Yes` = PhonePe sandbox for testing; `No` = live payments | No |
| **License Key** | Your PhonePe for WHMCS license key from relyweb.co | *(empty)* |

## The webhook URL

Register this URL in the PhonePe dashboard's webhook settings, using the same username and
password you enter above:

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

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

::: tip Where activity is logged
Every payment attempt and webhook exchange is recorded in the **Gateway Log** at **Utilities →
Logs → Gateway Log**. Check it first whenever a payment doesn't behave as expected.
:::

## Related pages

* [Configuration](/phonepe-whmcs/configuration) — each field explained in context
* [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