Accept crypto payments on XenForo
Let your members pay in crypto. The CryptoPayr add-on registers a native payment provider in XenForo, so user upgrades, paid registrations and any other purchasable can be bought with Bitcoin, Ethereum, USDT, USDC and 110+ other coins — settled to your USD wallet balance, with no chargebacks.
Pick the flow that suits your community: send members to the hosted checkout, or keep them on the forum with an on-site popup that closes itself and continues the purchase the moment the payment confirms. Either way the upgrade is only granted by a signed callback — the browser is never trusted to declare payment.
How to accept crypto payments on XenForo
Follow these steps to start taking Bitcoin, Ethereum, USDT and 110+ other coins.
-
Upload the add-on
Download the zip and upload the contents of
upload/to your XenForo root, so the add-on lands insrc/addons/CryptoPayr/Gateway/. -
Install it
Go to ACP → Add-ons and install CryptoPayr — Crypto Payments, or run
php cmd.php xf:addon-install CryptoPayr/Gateway. -
Create a payment profile
Open ACP → Setup → Payment profiles → Add payment profile and choose the provider CryptoPayr (cryptocurrency).
-
Paste your API key
Copy the secret key from Dashboard → Developers into the profile, choose the hosted or on-site popup flow, and save — the key is verified against the live API as you save it.
-
Attach it and test
Add the profile to a user upgrade under ACP → Users → User upgrades, then buy one with a small amount to see the upgrade granted automatically from the callback.
Need the full reference? See the API & webhook documentation, or read about the crypto payment gateway.
Requirements & compatibility
- XenForo 2.1.7+ (2.1 – 2.3) and PHP 7.2+
- Works with user upgrades, paid registration and add-on purchasables
- HTTPS forum reachable for callbacks
- A free CryptoPayr account & API key
Frequently asked questions
Can members buy user upgrades with crypto?
Yes — that is the main use. Attach the CryptoPayr payment profile to any user upgrade and the upgrade is applied automatically once the payment confirms on-chain.
Do recurring upgrades work?
Crypto cannot be pulled from a customer's wallet, so no gateway can auto-renew a crypto subscription. Sell upgrades as fixed-length, non-recurring purchases; members buy another term when it expires.
Is there anything to configure at CryptoPayr?
No. The add-on sends its own callback URL (/payment_callback.php?_xfProvider=cryptopayr) with every payment it creates, so there is no webhook to set up by hand.
How are callbacks secured?
Every callback carries an X-CryptoPayr-Signature header — an HMAC-SHA256 of the raw body keyed with your API key. The add-on verifies it, then checks the amount and currency match the purchase before completing it.
What happens if I refund a member?
Issue the refund from your CryptoPayr dashboard; the reversal callback tells XenForo to reverse the purchase, for example removing the user upgrade.
Does it support XenForo 3?
The add-on is built on the XenForo payment provider API that carries forward into XenForo 3. It is tested on XenForo 2.1 – 2.3, and we will publish a verified 3.x build as soon as XenForo 3 ships.