Skip to content
Payfim - Secure. Simple. Yours.
Coins

How to accept XRP payments (with destination tags)

To accept XRP, add an r-address from a self-custody XRP wallet to Payfim. Every invoice gets its own destination tag, payments are verified on validated ledgers within seconds, and no API key is needed.

PFPayfim Team · September 29, 2026 · 6 min read
How to accept XRP payments (with destination tags)
Key takeaways
  • Payfim assigns a unique destination tag to each XRP invoice; the customer must include it.
  • The standard XRP Ledger transaction cost is 10 drops (0.00001 XRP), and ledgers close about every 3 to 5 seconds.
  • Your receiving account must be activated with the 1 XRP base reserve before it can receive anything.
  • Never use an exchange XRP deposit address: the exchange needs its own tag to credit you.

XRP is the native currency of the XRP Ledger (XRPL), a public blockchain designed for fast settlement. It has a large base of holders, and payments complete in seconds for a tiny fee, which makes it a comfortable fit for checkout. It also has one quirk every merchant must understand: the destination tag.

What is an XRP destination tag, and why does Payfim use one?

On the XRP Ledger, a destination tag is a number attached to a payment that tells the recipient what the payment is for. Exchanges use it to know which customer to credit. Payfim uses it to know which invoice a payment belongs to.

When a customer chooses XRP at checkout, Payfim shows three things: your r-address, the amount, and a destination tag that belongs to that invoice alone. Because the tag identifies the invoice, the amount does not need to carry a unique fraction the way it does for Bitcoin or Litecoin. It also means that if a customer pays in two parts with the correct tag, Payfim adds them together.

If the customer leaves out the tag, the payment still reaches your wallet, but Payfim cannot tell which order it belongs to and will not mark anything paid. You can check it in your wallet and use Mark as paid manually on the invoice.

To prevent tagless payments entirely, you can turn on the XRPL account setting RequireDest in a wallet that supports it. The ledger will then reject payments to your address that have no destination tag, so the customer's wallet shows an error instead of sending.

Why do merchants accept XRP?

As with any non-stable coin, the value of what you receive moves with the market.

The 1 XRP reserve: activate your wallet first

An XRP Ledger account only exists once it holds at least the base reserve, currently 1 XRP on mainnet. Until then, a payment smaller than the reserve cannot create the account. In practice:

  1. Create your wallet and note its r-address.
  2. Send it a little more than 1 XRP from somewhere you already hold XRP.
  3. Only then publish it as your receiving address.

That reserve stays locked in the account. Each object the account owns (for example a trust line) adds an owner reserve of 0.2 XRP.

Setting up XRP in Payfim

  1. In Wallets & coins, paste your address into the XRP row. It starts with r and is 25 to 35 characters long, for example rN7n….
  2. Leave confirmations empty. Payfim only counts transactions in validated ledgers with a successful result, which are final.
  3. Switch XRP on, click Save wallets, then Test.

No API key is required. Payfim queries a public XRPL server by default; you can set your own under Blockchain APIs → XRPL server.

Payfim reads the amount the ledger actually delivered (the delivered_amount field), not the nominal amount written in the transaction. That closes the "partial payment" trick, where a payment claims a large amount but delivers only a fraction of it.

At checkout, the destination tag appears under your address, labeled "Destination tag (required)", with its own copy button. The QR code contains the address only, so the customer must enter the tag and the amount in their wallet themselves.

Which wallet should I use?

A self-custody XRP wallet, or a hardware wallet with an XRP app, where you control the secret. Payfim needs only the public r-address.

Exchange deposit addresses are a particularly bad fit for XRP. An exchange gives thousands of customers the same r-address and tells them apart by its own destination tag. Payfim puts its invoice tag on each payment, so the exchange has no way to match the deposit to your exchange account.

Common XRP mistakes

A final check before launch: send a small test payment with the tag from a second wallet, then one without it, so you see both outcomes in the invoice list and know what a missing-tag case looks like.

Keep going

Hosting providers using the WHMCS module or Blesta gateway often add XRP for international clients. For underpaid or split payments, see handling underpayments and refunds. Security practices for your gateway are on the security page.

Sources

Third-party facts were checked on the date shown above. Prices and features of other services change - always confirm on their official pages.

  1. XRPL.org: reserves
  2. XRPL.org: transaction cost
  3. XRPL.org: ledger close times
  4. XRPL.org: source and destination tags
  5. XRPL.org: partial payments

Frequently asked questions

What happens if a customer forgets the XRP destination tag?

The XRP arrives in your wallet, but Payfim cannot link it to an invoice. Verify it in your wallet and use Mark as paid manually, or enable RequireDest so tagless payments are rejected.

Does every XRP invoice get a different destination tag?

Yes. Payfim generates a unique tag per invoice.

How much XRP do I need to activate my receiving wallet?

The XRP Ledger base reserve is currently 1 XRP. Fund the address with a bit more than that before accepting payments.

Can I use my exchange XRP address?

No. Exchanges rely on their own destination tags to credit your account, which conflicts with the per-invoice tags Payfim uses.

How long do XRP payments take?

Ledgers close about every 3 to 5 seconds. Payfim marks the invoice paid once the payment is in a validated ledger and the gateway runs its next check.

Accept crypto on your store today

Self-hosted, non-custodial, zero fees. Lifetime license.