# Accept XRP payments on FOSSBilling

> Step-by-step: accept XRP on FOSSBilling 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-fossbilling/
Updated: 2026-11-15

FOSSBilling clients can pay invoices in XRP with the PayGateCrypto adapter. 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 FOSSBilling plugin

Download the adapter from the [FOSSBilling crypto page](https://withoutkyc.to/crypto-payment-gateway-no-kyc-instant-payouts/fossbilling/), upload the `PayGateCrypto` folder into `library/Payment/Adapter/` (XRP needs version 1.0.1 or newer), then **System › Payment gateways › New payment gateway** and install **PayGateCrypto**.

## Step 3: Paste your XRP wallet

Open **System › Payment gateways › PayGateCrypto**.

- **Network wallets:** paste your XRP wallet into **XRP Ledger wallet**, switch on **Enabled** and **Allow One Time Payments**, and click **Update Gateway**.

![FOSSBilling PayGate.to settings showing the XRP Ledger wallet field](https://withoutkyc.to/knowledge-base/images/xrp-fossbilling/01-xrp-field.webp)
*The XRP Ledger wallet field in FOSSBilling. (Filled with a test address.)*

## 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**. The adapter checks the signature, the coin, the amount and that the payout went to your wallet before paying the invoice.

## XRP on FOSSBilling: 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.
- Confirmations go to `ipn.php`: FOSSBilling must be reachable at its public https address.
- Repeated confirmations are ignored, so a replayed callback can't pay an invoice twice.
- **Order statuses:** Unpaid → Paid.

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

## 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/) · [WHMCS](https://withoutkyc.to/knowledge-base/accept-crypto/xrp-whmcs/) · [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.
