XBI Revolut Payment Gateway for WHMCS
Installation & Configuration Guide
1. Requirements
- WHMCS 8.x or higher
- PHP 8.0 or higher
- Revolut Business Account (Merchant API access)
2. Installation
- Unzip the downloaded file.
- Upload the
modulesfolder to your WHMCS root directory, maintaining the structure.- The path should look like:
your-whmcs/modules/gateways/xbi_revolut.php
- The path should look like:
3. Configuration in WHMCS
- Log in to your WHMCS Admin Area.
- Navigate to System Settings > Payment Gateways.
- Click All Payment Gateways and activate XBI Revolut.
- Configure the following settings:
- License Key: Enter the license key provided by XBI.
- Secret API Key: Your Revolut Production Secret Key (starts with
sk_). - Public API Key: Your Revolut Production Public Key (starts with
pk_). - Payment Flow:
- Popup (Integrated): Recommended. Keeps the user on your site. Required for immediate auto-redirect.
- Redirect (Hosted Page): Sends user to a Revolut hosted page.
- Test Mode: Check ONLY if you are using Sandbox keys.
4. Apple Pay & Google Pay Setup (Critical)
For Apple Pay to appear in the Popup, you must verify your domain:
- Go to your Revolut Business Dashboard > Merchant API > Revolut Pay.
- Download the HTML verification file.
- Upload it to your website's root folder (public_html).
- Click "Verify" in the Revolut Dashboard.
5. Webhook Setup
The module attempts to register the webhook automatically.
- Manual Setup (If needed):
- Go to Revolut Dashboard > Merchant API > Webhooks.
- Set URL to:
https://your-whmcs-domain.com/modules/gateways/callback/xbi_revolut.php - Event:
ORDER_COMPLETED.
