---
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 lists every admin setting RelyPay exposes, what each one does, the choices you
have, and its default. Most settings live under **Addons → RelyPay → Global Settings**,
which has four sections in the left sidebar: **Default Gateways**, **Sync Manager**,
**Update Status**, and **License Information**. Recurring behaviour is configured on its
own tab, **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 — **RelyPay — Default Domestic** (all INR methods) and
**RelyPay — Default International** (all non-INR methods) — expose every method for their
currency scope in a single checkout option. These two settings choose which provider each
of those gateways sends payments to.

![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

Recurring settings live on **Addons → RelyPay → Recurring**. Recurring charges run through
PayGlocal Standing Instructions (SI) on **international card** transactions: a mandate is
created during the customer's first card payment, and the daily WHMCS cron then charges
upcoming invoices automatically. For the full walkthrough 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
Leave **Recurring Mode** on **Off** unless you have a PayGlocal account configured and want
to charge cards on a schedule. In **Strict** mode, every international card payment creates
a mandate — make sure that is the behaviour you intend before switching it on.
:::

## 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
