Skip to content

Updated 20 Nov 2026

XenForo crypto payment gateway

Plaxswap Crypto Payment Gateway is a free XenForo add-on for payment profiles. A member pays for an upgrade in Bitcoin, USDT or another coin on our hosted checkout, and the purchase activates once the add-on has verified the payment.

Add-on details

Price
Free on xenforo.com
Version
1.0.6, from 11 Nov 2026. First published 21 Oct 2026
Needs
XenForo 2.3 and PHP 7.2 with OpenSSL, or newer
Works with
One-time purchases through payment profiles, such as user upgrades
Platform fee
1.5% of each payment, paid by your member and shown at checkout. The add-on adds nothing on top
Time to pay
60 minutes, set by the add-on
Short payments
Paid if the member sent at least 99.5% of the amount. You can raise the allowance to 10%
Payment size
From about $1 to about $500,000. The checkout shows the limit for each coin

Set up the add-on

  1. Open a merchant account. Sign in with Google or Telegram, finish the business setup and turn on your authenticator app.
  2. Download the add-on from xenforo.com and back up your forum. In the Admin CP, open Add-ons, choose Install/upgrade from archive and upload the ZIP. Later versions upgrade the same way.
  3. In your merchant dashboard, open Developers, then API keys. Choose New key, select Test and choose Create test key. It starts with pxs_test_ and is shown only once.
  4. Open Developers, then Webhooks. Choose Make a new secret and copy it. It starts with whsec_ and is shown only once.
  5. In the Admin CP, open Setup, then Payment profiles, and add Plaxswap Crypto Payment Gateway. Paste the key and the secret and save.
  6. Reopen the profile and copy its callback URL. It looks like https://forum.example/payment_callback.php?_xfProvider=plaxswap_gateway&profile_id=1. In Webhooks, choose Add URL, paste it and choose Save.
  7. Switch the dashboard to Test, choose Send test and check that Delivery history shows Delivered.
  8. Attach the profile to a one-time user upgrade and buy it as a forum administrator. Act out a payment on the test checkout, then check Payments & tracking in the Admin CP.
  9. When that works, create a live key (pxs_live_) in the same merchant account, paste it into the profile and make one small real payment.

Moving from Coinbase Commerce? See what to check when you switch.

What happens to a XenForo purchase

The add-on never trusts a returning member or a notification alone. A signed webhook makes it ask our API about the payment, and it checks the invoice, amount, currency and mode first.

PaymentPurchaseWhat it means
Waiting for the member to payNot activeThe forum payment page shows the status.
Seen on the network, still confirmingNot activeThe member can follow the confirmations.
Short by no more than your allowanceActiveCounts as paid. The allowance is 0.5% by default.
Short by more than your allowanceNot activeThe purchase waits.
Paid, transfer under reviewNot activeIt activates when the review clears.
Paid and verifiedActive, onceDuplicate or late checks can't grant it twice.
Expired, cancelled or failedNot activeNothing is granted.
Paid up to 24 hours lateActive after verificationThe add-on keeps checking expired invoices for late coins.

If a webhook is missed, the add-on's cron checks unfinished payments: every run in the first hour, every 10 minutes for about a day, then hourly for up to 30 days. A merchant account has one webhook URL, so a second forum on it relies on the cron.

What your member sees

The member presses Pay and goes straight to our hosted checkout. They pick a coin and network, and see the amount, address, QR code and every charge before they send. Then they return to the forum's payment page, which shows the status. It takes multiple coins and networks, including BTC, ETH, USDT, USDC, SOL, TRX, BNB, LTC, DOGE, BCH, XRP, GRAM, AVAX, POL, DAI and DASH.

Costs and your money

On a $100 upgrade, your member sends about $101.50 in the coin they chose, plus the network fee, and about $100 in that coin reaches your merchant balance. When you withdraw, you pay our 0.3% fee and the network fee, both shown before you approve. Work out other amounts with the fee calculator, and see every cost on the fees page.

Limits to know first

  • Payments are one-time. Recurring user upgrades and automatic renewals aren't supported.
  • Refunds aren't automatic, and a crypto payment can't be reversed.
  • You receive the coin your member paid with, in your Plaxswap merchant balance. The add-on can't withdraw your funds.
  • A live forum needs https:// and a public callback URL.
  • Credentials are encrypted with your globalSalt, so back up src/config.php and the database together.

If something goes wrong

What you seeWhat to check
A member can't start a paymentThe member sees the reason. With a test key, only forum administrators can pay. A live forum needs https://.
The API key is rejectedUse a pxs_test_ or pxs_live_ key. A swap partner key (pxk_) doesn't work here.
Send test failsThe callback URL must be public HTTPS with your real profile_id. A login prompt or firewall must not block it.
The log says Ignored: other modeWith a test key saved, switch the merchant dashboard to Test before you choose Send test.
Paid, but the upgrade isn't activeCheck the payment again in Payments & tracking, and make sure XenForo scheduled jobs run.
Checks paused on a profileThe key was switched off or deleted. Save the profile with a working key and checks resume.

Still stuck? Contact support with your add-on version, XenForo version and the payment reference. Never send an API key, signing secret, recovery phrase or authenticator code.

Questions

Is the XenForo add-on free?

Yes, it's a free download on xenforo.com. Your member pays our 1.5% platform fee, and you pay 0.3% plus the network fee when you withdraw.

Which XenForo purchases does it work with?

One-time purchases that use XenForo payment profiles, such as user upgrades. Recurring upgrades aren't supported, and the member is asked to choose another payment method. Guests can't pay.

Can I test it without real coins?

Yes. Save a test key and buy as a forum administrator. Other members can't pay with a test key, so a simulated payment never grants real access.

How do refunds work?

Refunds are manual, and a crypto payment can't be reversed. Send the coins back from your merchant balance or your own wallet, then remove the upgrade in XenForo.

What happens if I uninstall the add-on?

It disables its payment profiles and deletes its invoice table, so back up first. Disabling the add-on keeps the history. To cut off the forum's access, revoke its key under API keys.

Related

Running a shop too? See the WooCommerce plugin. To build your own checkout, read the payment API docs, or see the crypto payment gateway. The add-on itself is on xenforo.com. See every plugin, including WHMCS and FOSSBilling, on the integrations page.

Using Plaxswap means you accept our terms and privacy notice, recorded with your IP address and browser details. Extra cookies are optional.