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
- Open a merchant account. Sign in with Google or Telegram, finish the business setup and turn on your authenticator app.
- 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.
- 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.
- Open Developers, then Webhooks. Choose Make a new secret and copy it. It starts with whsec_ and is shown only once.
- In the Admin CP, open Setup, then Payment profiles, and add Plaxswap Crypto Payment Gateway. Paste the key and the secret and save.
- 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.
- Switch the dashboard to Test, choose Send test and check that Delivery history shows Delivered.
- 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.
- 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.
| Payment | Purchase | What it means |
|---|---|---|
| Waiting for the member to pay | Not active | The forum payment page shows the status. |
| Seen on the network, still confirming | Not active | The member can follow the confirmations. |
| Short by no more than your allowance | Active | Counts as paid. The allowance is 0.5% by default. |
| Short by more than your allowance | Not active | The purchase waits. |
| Paid, transfer under review | Not active | It activates when the review clears. |
| Paid and verified | Active, once | Duplicate or late checks can't grant it twice. |
| Expired, cancelled or failed | Not active | Nothing is granted. |
| Paid up to 24 hours late | Active after verification | The 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 see | What to check |
|---|---|
| A member can't start a payment | The member sees the reason. With a test key, only forum administrators can pay. A live forum needs https://. |
| The API key is rejected | Use a pxs_test_ or pxs_live_ key. A swap partner key (pxk_) doesn't work here. |
| Send test fails | The 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 mode | With a test key saved, switch the merchant dashboard to Test before you choose Send test. |
| Paid, but the upgrade isn't active | Check the payment again in Payments & tracking, and make sure XenForo scheduled jobs run. |
| Checks paused on a profile | The 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.