Appearance
Connect PhonePe
PhonePe covers UPI, Cards, Net Banking and Wallets. Connect it on the Addons → RelyPay → Providers page using the credentials from your PhonePe Business account.
Addons → RelyPay → Providers → PhonePe
Credentials you will need
On the PhonePe card, fill in these fields exactly:
| Field | Where to find it |
|---|---|
| Client ID | From PhonePe Business Dashboard |
| Client Secret | From PhonePe Business Dashboard |
| Client Version | API version (default: 1) |
Leave Client Version at 1 unless PhonePe has asked you to use a different API version.
Options
- Payment Mode — choose Redirect or Iframe. How the checkout is displayed. Redirect sends the customer to PhonePe; Iframe embeds the checkout on your site.
- Sandbox Mode — toggle. Enable for testing. Turn this on to trial the integration against PhonePe's sandbox, and off for live payments.
Webhook authentication
PhonePe authenticates its webhook with a username and password that you set. Enter matching values in both places — the PhonePe dashboard and RelyPay:
| Field | Purpose |
|---|---|
| Webhook Username | For webhook authentication |
| Webhook Password | For webhook authentication |
Register the webhook
- On the PhonePe card in RelyPay, copy the webhook URL shown.
- In the PhonePe Business Dashboard, add that URL as your webhook endpoint and set the username and password to match the values you entered in RelyPay.
- Subscribe to these events:
| Event | Required? |
|---|---|
checkout.order.completed | Required |
checkout.order.failed | Optional |
SSL required
The webhook URL must be HTTPS. PhonePe will not deliver events to an insecure endpoint, and RelyPay verifies each callback.
Test it
- Click Test Connection on the PhonePe card to confirm your credentials reach PhonePe.
- Enable PhonePe and save.
- Place a test payment through a RelyPay sub-gateway that PhonePe can serve, and confirm the result appears in the transaction log with PhonePe as the provider.