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

Accept Monero (XMR) payments on Magento

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

3 min readUpdated Beginner
On this page
  1. Step 1: Get a Monero wallet address
  2. Step 2: Install or update the Magento plugin
  3. Step 3: Paste your Monero wallet
  4. Step 4: What your customer sees
  5. Step 5: Order completed automatically
  6. Monero on Magento: good to know
  7. Frequently asked questions

Magento 2 stores can offer Monero as an individual coin (QR code on the order confirmation page) or on the hosted multi-coin page. Monero (XMR) keeps amounts, senders and receivers private on its blockchain, which is exactly why many customers prefer it. With PayGate.to, each order gets a one-time Monero address and the XMR is forwarded to your own Monero wallet once it unlocks.

Step 1: Get a Monero wallet address

You need a Monero address you control: a main address (4…) or a subaddress (8…), 95 characters. Get one from Feather Wallet on a computer or Cake Wallet on a phone. We confirmed that PayGate.to accepts subaddresses as payout wallets.

Step 2: Install or update the Magento plugin

Install the module with Composer or by copying it to app/code/PayGate/CryptoPayment/, then run the bin/magento setup commands, as shown in Crypto payments on Magento.

Step 3: Paste your Monero wallet

Open Stores › Configuration › Sales › Payment Methods › PayGate.to Crypto Payments.

  • Multicoin: paste your Monero wallet into Monero Wallet (XMR) and click Save Config.
  • Individual coins: tick Monero and insert the same wallet. Customers pay the QR code on your order confirmation page.
Magento PayGate.to settings showing the Monero Wallet (XMR) field
The Monero Wallet (XMR) field in Magento: paste your Monero address here.

Step 4: What your customer sees

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

PayGate.to payment details: 0.09898687 XMR for a 49.90 USD order, one-time address and QR code
Monero payment details on the hosted checkout.

Step 5: Order completed automatically

When the payment is confirmed, the order is invoiced and moves to Processing, and the invoice email is sent. The admin order page shows the amounts received, transaction IDs and the IPN token.

Monero on Magento: good to know

  • Minimum: 0.01 XMR at the time of writing (live minimums).
  • Timing: Monero blocks arrive every ~2 minutes and received funds unlock after 10 blocks (~20 minutes) before forwarding.
  • Privacy: customers never see your wallet address; outsiders can't link the payment to it on the blockchain.
  • The quoted coin amount is honoured for 3 hours.
  • Underpaid orders go On Hold; the customer can send the rest to the same address and both payments are added up.
  • The callback URL /paygatecrypto/callback/index must be reachable: no password, IP allow-list or maintenance mode in front of it.
  • Order statuses: Awaiting crypto payment → Processing; On Hold if underpaid; cancelled after Cancel Unpaid Orders After (48 hours by default).

Frequently asked questions

Can I use a Monero subaddress?

Yes. Subaddresses (8…) and main addresses (4…) both work as payout wallets.

Why does the order take about 20 minutes to complete?

Monero locks received funds for 10 blocks. The customer has paid; forwarding waits for the unlock, then the order updates automatically.

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 Monero?

WooCommerce · Easy Digital Downloads · WHMCS · FOSSBilling · OpenCart · PrestaShop · Paymenter. See Accept Monero (XMR) payments for the overview.

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