Skip to content

Configuration

Connect at least one payment provider on one screen: Addons → RelyPay → Providers. Enter credentials, test, then register RelyPay's webhook URL in the provider's dashboard.

The RelyPay Providers page listing all five providersAddons → RelyPay → Providers

Connect a provider

  1. Addons → RelyPay → Providers → select the provider.
  2. Enter its credentials (see the table below and the per-provider guide).
  3. Enable the provider.
  4. Test Connection — verifies the credentials with the provider before any customer reaches checkout. Fix the keys if it fails.
  5. Copy the webhook URL RelyPay shows and register it in the provider dashboard (next section).

Configure only the providers you will route to; configuring more than one lets routing spread traffic and fall back automatically.

Credentials by provider

ProviderKey credentialsNotable optionsGuide
RazorpayKey ID, Key Secret, Webhook SecretPayment Action (Capture / Authorize)Razorpay
CashfreeApp ID, Secret KeyTest Mode, Checkout Mode (Redirect / Popup)Cashfree
PhonePeClient ID, Client Secret, Client VersionPayment Mode (Redirect / Iframe), Sandbox ModePhonePe
PayGlocalMerchant ID, private/public key paths & IDsTest Mode; powers recurring on international cardsPayGlocal
Zoho PaymentsAccount ID, API Key, OAuth Client ID, Client Secret, Refresh TokenData Center, Webhook Secret, Test ModeZoho

Set up webhooks

A webhook lets a provider report a payment's outcome (captured, failed, cancelled) even if the customer closes the browser. Without it, a paid invoice may not be marked paid.

For each provider:

  1. Copy the webhook URL from the provider's config page in RelyPay.
  2. Paste it into the provider dashboard's webhook/callback field.
  3. Subscribe to the events RelyPay lists — required events must be on; optional ones enrich the transaction log.
  4. Save in the provider dashboard.

Each provider guide lists that provider's exact events and marks the required ones.

HTTPS required

Webhook endpoints must be served over HTTPS with a valid certificate — providers refuse to deliver to an insecure URL, and RelyPay signature-verifies every callback.

Every callback is verified

RelyPay signature-verifies every provider callback and ignores duplicates, so a payment is never processed twice.

Next

Provider guides: Razorpay · Cashfree · PhonePe · PayGlocal · Zoho

Documentation for the Relyweb app catalogue.