# Accept XRP payments on WHMCS

> Step-by-step: accept XRP on WHMCS with the free PayGate.to plugin, paid instantly to your own wallet. Wallet, settings field, checkout and order statuses.

Source: https://withoutkyc.to/knowledge-base/accept-crypto/xrp-whmcs/
Updated: 2026-11-15

WHMCS clients can pay invoices in XRP through the Multicoin gateway (hosted page) or the Individual Coins gateway (QR code on the invoice). XRP settles in seconds with tiny fees. PayGate.to supports **native XRP on the XRP Ledger**: each order gets a one-time XRP address (no tag needed by the customer), and the XRP is forwarded to **your own wallet**, including your destination tag if your account needs one.

## Step 1: Get an XRP wallet address

You need an XRP address you control (`r…`), from [Trust Wallet](https://withoutkyc.to/knowledge-base/wallet-setup/create-trust-wallet/) or [OKX Web3 Wallet](https://withoutkyc.to/knowledge-base/wallet-setup/create-okx-web3-wallet/). If your account needs a tag, write it as `r…?dt=TAG` or use an X-address. Details: [Get an XRP address with a destination tag](https://withoutkyc.to/knowledge-base/wallet-setup/xrp-wallet-destination-tag/).

> **Choose **XRP on the XRP Ledger** in your wallet, not XRP tokens on BNB Smart Chain or Ethereum, which use `0x…` addresses.**

## Step 2: Install or update the WHMCS plugin

Download the module from the [WHMCS crypto module page](https://withoutkyc.to/crypto-payment-gateway-no-kyc-instant-payouts/whmcs/), unzip it and upload the `modules` folder into your WHMCS root (use the latest version for XRP). Activate the gateways under **Configuration › System Settings › Payment Gateways › All Payment Gateways**.

## Step 3: Paste your XRP wallet

Open **Configuration › System Settings › Payment Gateways**.

- **Crypto Payment Gateway — Multicoin:** paste your XRP wallet into **XRP Wallet Address (XRP Ledger)** and save. Clients click **Pay with cryptocurrency** and choose XRP.
- **Crypto Payment Gateway — Individual Coins:** fill in the **XRP** wallet field (one field per coin, loaded live) and save. Clients pick XRP and see the QR code on the invoice.

The field is labelled **XRP Wallet Address (XRP Ledger)**. Leave every network you don't want empty.

## Step 4: What your customer sees

The customer chooses XRP, gets the exact amount converted from your order total, a one-time address and a QR code.

![PayGate.to payment details: 52.60721050 XRP for a 49.90 USD order, one-time address and QR code](https://withoutkyc.to/knowledge-base/images/accept-xrp-payments/02-payment.webp)
*XRP payment details on the hosted checkout.*

## Step 5: Order completed automatically

When the payment is confirmed, the XRP is forwarded to your wallet and the invoice is marked paid. Each callback is recorded in the Gateway Log.

## XRP on WHMCS: good to know

- **Minimum:** 2 XRP at the time of writing ([live minimums](https://withoutkyc.to/fees/)). A new address needs 1 XRP reserve; the first payout covers it.
- **Timing:** XRP Ledger payments are final in a few seconds.
- **Callbacks:** `address_out` lists your payout as `r…?dt=TAG`, even if you entered an X-address.
- Set the WHMCS **System URL** to your public https address, and keep `/modules/gateways/callback/` reachable.
- Don't edit the invoice Notes while a crypto payment is pending: the module keeps its payment data there.
- In Individual Coins mode, a payment in a different token is still forwarded to you but the invoice isn't marked paid automatically. More in [WHMCS troubleshooting](https://withoutkyc.to/whmcs-payment-gateway-troubleshooting/).
- **Order statuses:** Unpaid → Paid; "Underpaid" entries appear in the Gateway Log.

> **The full WHMCS setup, with every coin and option, is in [Crypto payments on WHMCS](https://withoutkyc.to/knowledge-base/accept-crypto/crypto-payments-whmcs/) and on the official [WHMCS plugin page](https://withoutkyc.to/crypto-payment-gateway-no-kyc-instant-payouts/whmcs/). Also on WHMCS: [Monero (XMR) on WHMCS](https://withoutkyc.to/knowledge-base/accept-crypto/monero-whmcs/).**

## Frequently asked questions

### Do customers need to enter a destination tag?

No. They pay a one-time address without a tag. Only your payout wallet may have one.

### Can I paste an X-address into the field?

Yes. The plugin accepts `r…`, `r…?dt=TAG` and mainnet X-addresses.

### Do I need an account or API key?

No. The plugin only needs your public wallet addresses. Neither you nor your customers register with PayGate.to.

### Which other platforms support XRP?

[WooCommerce](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-woocommerce/) · [Easy Digital Downloads](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-easy-digital-downloads/) · [FOSSBilling](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-fossbilling/) · [Magento](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-magento/) · [OpenCart](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-opencart/) · [PrestaShop](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-prestashop/) · [Paymenter](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-paymenter/). See [Accept XRP payments](https://withoutkyc.to/knowledge-base/accept-crypto/accept-xrp-payments/) for the overview.
