---
url: /relypay-whmcs/settings.md
description: >-
  Every RelyPay Global Settings option explained — Default Gateways, Sync
  Manager, and Recurring — with each setting's purpose, choices, and default
  value.
---

# Settings reference

This page documents all administrator configuration settings in RelyPay:

* **Global Settings:** Located under **Addons → RelyPay → Global Settings** (**Default Gateways**, **Sync Manager**, **Update Status**, and **License Information**).
* **Recurring Settings:** Located under **Addons → RelyPay → Recurring**.
  For update and licensing settings, see [Updating](/relypay-whmcs/updating),
  [Backup & restore](/relypay-whmcs/backup-and-restore), and
  [Licensing](/relypay-whmcs/licensing).

## Global Settings → Default Gateways

The two default sub-gateways group payment methods under a single checkout option:

* **RelyPay — Default Domestic:** Covers all INR methods (UPI, Cards, Net Banking, Wallets, Pay Later, EMI).
* **RelyPay — Default International:** Covers all non-INR methods (Cards, PayPal, Other).

![Default Gateways settings](/relypay-whmcs/img/relypay-settings-default-gateways.png)
*Addons → RelyPay → Global Settings → Default Gateways*

| Setting | What it does | Options | Default |
| --- | --- | --- | --- |
| **Default Domestic Provider** | Chooses the provider that handles **RelyPay — Default Domestic** (all INR methods: UPI, Cards, Net Banking, Wallets, Pay Later, EMI). | Any enabled, configured provider that supports INR methods. | Not set until you choose one |
| **Default International Provider** | Chooses the provider that handles **RelyPay — Default International** (all non-INR methods: Cards, PayPal, Other). | Any enabled, configured provider that supports non-INR methods. | Not set until you choose one |

Click **Save Default Gateway Settings** to apply your choices.

::: info
These settings only affect the two "Default" sub-gateways. The method-specific
sub-gateways (UPI, Cards, and so on) are resolved by your rules on
**Addons → RelyPay → Routing** instead. See [Routing](/relypay-whmcs/features/routing).
:::

## Global Settings → Sync Manager

Sync Manager keeps RelyPay's deployed files, sub-gateways, and provider setup consistent.
It has one setting plus several read-only panels.

![Sync Manager panels](/relypay-whmcs/img/relypay-settings-sync-manager.png)
*Addons → RelyPay → Global Settings → Sync Manager*

| Setting | What it does | Options | Default |
| --- | --- | --- | --- |
| **Auto-Sync on Admin Page Load** | When on, RelyPay automatically re-syncs its deployed files whenever an admin page loads and a mismatch is detected — so you rarely need to sync by hand. | On / Off | On |

### What the panels show

| Panel | What it shows |
| --- | --- |
| **Sync Required / Everything In Sync** banner | Whether anything needs syncing. When all is well it reads *"All providers, sub-gateways, and deployed files are up to date."* |
| **Deployment Sync Status** | A table of components with columns **Component / Status / Details / Actions**, with a **Sync** action per component and a full re-sync. |
| **Vendor Dependencies** | A table with columns **Provider / Status / Path / Action** showing each provider's supporting files. |
| **File Integrity** | Verifies deployed files against a signed snapshot and flags any tampered or missing file. |
| **Sync History (Last 5)** | Recent sync activity, with columns **Date / Changes / Action / Status / Message**. |

::: tip
If a banner ever reports that a sync is required, click the relevant **Sync** action (or
the full re-sync) and the status will return to *Everything In Sync*.
:::

## Recurring

Configure recurring billing at **Addons → RelyPay → Recurring**. Recurring payments utilize PayGlocal Standing Instructions (SI) on international card transactions to automate invoice renewals via the daily WHMCS cron. See [Recurring payments](/relypay-whmcs/features/recurring-mandates).

![Recurring settings](/relypay-whmcs/img/relypay-settings-recurring.png)
*Addons → RelyPay → Recurring*

| Setting | What it does | Options | Default |
| --- | --- | --- | --- |
| **Recurring Mode** | Controls whether — and how — international card payments create a mandate for future auto-charges. | **Flex** (customer sees an opt-in checkbox below the Pay Now button), **Strict** (every international card payment creates a mandate), **Off** (standard card payment only). | **Off** |
| **SI Max Amount Multiplier** | Caps any future auto-charge as a multiple of the first invoice amount, so a mandate can never charge more than expected. | 1x – 5x | **3x** |
| **Days Before Due to Charge** | How many days before an invoice's due date the daily cron attempts the auto-charge. | 1 – 5 days | **2** |
| **Recurring Payment Gateway** | The provider used for recurring charges. Only providers that support international cards plus SI mandates are listed. | Any listed SI-capable provider (currently PayGlocal). | **PayGlocal** |

::: warning
Keep **Recurring Mode** set to **Off** until PayGlocal credentials are fully configured. In **Strict** mode, every international card transaction automatically registers a recurring mandate.
:::

## Related pages

* [Configuration](/relypay-whmcs/configuration) — provider credentials and webhooks
* [Routing](/relypay-whmcs/features/routing) — the four routing layers, in order
* [Recurring payments](/relypay-whmcs/features/recurring-mandates) — mandates end to end
* [Updating](/relypay-whmcs/updating) and [Backup & restore](/relypay-whmcs/backup-and-restore)
* [Licensing](/relypay-whmcs/licensing) — license types and where to enter your key