Knowledge Base
  1. Home
  2. Knowledge Base
  3. Accept crypto payments
Accept crypto payments

Accept XRP payments (with destination tags)

Accept native XRP on the XRP Ledger with PayGate.to: plugins and API, payouts to r… addresses, r…?dt=TAG or X-addresses, real screenshots and tested callbacks.

3 min readUpdated Beginner
On this page
  1. What you need
  2. XRP on your platform
  3. What your customer sees
  4. XRP with the API
  5. Minimum, reserve and timing
  6. Hosted multi-coin checkout
  7. Frequently asked questions

XRP settles in seconds with tiny fees, which makes it pleasant for customers and merchants alike. PayGate.to supports native XRP on the XRP Ledger: customers pay a one-time address, and the XRP is forwarded to your wallet, including your destination tag if your account needs one.

What you need

XRP on your platform

Paste your XRP wallet into the plugin's XRP wallet field. Platform guides with screenshots:

PlatformGuide
WooCommerceXRP on WooCommerce
Easy Digital DownloadsXRP on Easy Digital Downloads
WHMCSXRP on WHMCS
FOSSBillingXRP on FOSSBilling
MagentoXRP on Magento
OpenCartXRP on OpenCart
PrestaShopXRP on PrestaShop
PaymenterXRP on Paymenter

What your customer sees

We created a 49.90 USD checkout with an r…?dt=777 payout wallet:

PayGate.to hosted checkout with XRP selected
The customer picks XRP.
PayGate.to payment details: 52.60721050 XRP, one-time payment address and QR code
A one-time XRP address. The customer doesn't need a tag; network fees were added with add_fees=1.

The customer pays the one-time address without any destination tag. PayGate.to adds your tag when it forwards the XRP to you.

XRP with the API

bash
curl "https://api.paygate.to/crypto/xrp/wallet.php?address=rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn%3Fdt%3D777&callback=https%3A%2F%2Fshop.example8585859.com%2Fpaygate%2Fcallback%3Forder%3D1001"

Note the URL-encoded ?dt=777 (%3Fdt%3D777). In the callback, address_out lists your payout as rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn?dt=777, also when you configured an X-address. See XRP payment API.

Minimum, reserve and timing

  • Minimum: 2 XRP at the time of writing (live minimums).
  • Reserve: a new XRP address needs 1 XRP to exist on the ledger; the first payout covers it.
  • Timing: XRP Ledger payments are final in a few seconds.

Hosted multi-coin checkout

If you build your own checkout with POST /crypto/multi-hosted-wallet.php, the key for native XRP is xrp. With an EVM wallet set too, customers can also see XRP tokens on other networks, but native XRP is the one paid out to your r… wallet.

Frequently asked questions

Do customers need to enter a destination tag?

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

Can I use an X-address?

Yes. PayGate.to accepts mainnet X-addresses as payout wallets and forwards to the classic address with the encoded tag.

Is XRP on BNB Smart Chain the same?

No. That's a token on another network, sent to an 0x… address. Native XRP on the XRP Ledger uses r… addresses and the xrp ticker.

What if my wallet is a new XRP address?

The first payout of at least 2 XRP activates it (1 XRP stays as the account reserve).

This guide is also available as Markdown for AI assistants and offline reading.