---
url: /relypay-whmcs/guides/payglocal.md
description: >-
  Set up PayGlocal in RelyPay for WHMCS — enter your merchant ID and key file
  paths, enable test mode, and power recurring card mandates on international
  cards.
---

# Connect PayGlocal

PayGlocal handles **international cards** and is the provider behind RelyPay's
**recurring / Standing Instruction (SI)** mandates. If you charge overseas customers or run
recurring card billing, this is the provider to connect. Set it up on the
**Addons → RelyPay → Providers** page.

![The PayGlocal configuration card in RelyPay](/relypay-whmcs/img/relypay-payglocal-config.png)
*Addons → RelyPay → Providers → PayGlocal*

## Credentials you will need

PayGlocal uses a pair of signing/encryption keys stored as `.pem` files on your server,
plus their IDs. On the PayGlocal card, fill in these fields exactly:

| Field | Where to find it / what to enter |
| --- | --- |
| **Merchant ID** | From PayGlocal Dashboard |
| **Private Key Path** | Absolute server path to merchant private key (.pem) |
| **Private Key ID** | Key ID for signing |
| **Public Key Path** | Absolute server path to PayGlocal public key (.pem) |
| **Public Key ID** | Key ID for encryption |

Upload both `.pem` files to your server first, then enter their **absolute paths**. The
**private key** signs your requests; the **public key** encrypts data for PayGlocal.

::: warning Keep your key files private
Store the `.pem` files outside the web root, or otherwise block web access to them. They
are credentials — anyone who can read them can act as your merchant account.
:::

## Options

* **Test Mode** — toggle. *Enable for sandbox testing.* Use PayGlocal's sandbox while you
  trial the integration; disable it for live payments.

## Recurring on international cards

PayGlocal is the provider that supports **recurring payments via Standing Instructions**
on international cards. A mandate is created during the first card payment, and the daily
WHMCS cron then charges upcoming invoices automatically within the limits you set. To turn
this on and configure the mandate cap and charge timing, see
[Recurring payments](/relypay-whmcs/features/recurring-mandates).

## Test it

1. Click **Test Connection** on the PayGlocal card to confirm your credentials and key
   paths are valid.
2. Enable PayGlocal and save.
3. Place a test international-card payment through a RelyPay
   [sub-gateway](/relypay-whmcs/features/sub-gateways), and confirm the result appears in
   the [transaction log](/relypay-whmcs/features/transactions) with **PayGlocal** as the
   provider.

## Related

* [Configuration overview](/relypay-whmcs/configuration)
* [Recurring payments](/relypay-whmcs/features/recurring-mandates)
* [Routing](/relypay-whmcs/features/routing)