XenForo BTCPay Server Payment Provider 2.0.3

💰 XenForo BTCPay Server Payment Provider​

BTCPay Server is an open-source and secure payment infrastructure that lets you accept payments in Bitcoin and other cryptocurrencies. With the BTCPay payment provider add-on for XenForo, you can accept crypto payments for things like user upgrades.

⚠️ Notes

• The add-on does not support automatically renewing payments.
• The add-on does not support refunds.

Click to expand...

You can install the add-on via the XenForo admin panel or manually over FTP.

After installation, you can check our BTCPay Server setup guide: 🔗 BTCPay Server Installation on Ubuntu 24.04 (2025 Updated Guide)

---

⚙️ Configuration Steps​

1️⃣ Create a Payment Profile​

1. Open the XenForo admin panel: /admin.php
2. From the left menu, go to Setup > Payment profiles.
3. Click Add payment profile.
4. Select BTCPay Server as the provider.
5. Click Proceed….
6. In the Host field, enter your full BTCPay Server address,
   e.g.: btcpay.yoursite.com

2️⃣ Generate an API Key​

1. Log in to your BTCPay Server.
2. Go to Account > Manage Account (bottom-left).
3. Open the API Keys tab.
4. Click Generate Key.
5. Grant these permissions:
   btcpay.store.cancreateinvoice — create invoices
   btcpay.store.canviewstoresettings — view store settings
6. Click Generate API Key.
7. Copy the API key and paste it into the BTCPay payment profile form in XenForo.

3️⃣ Set Up the Webhook​

1. In BTCPay Server, go to Settings > Webhooks.
2. Click Create Webhook.
3. In Payload URL, paste the URL adjusted for your forum:
   
   https://www.jetto.net/redirect?to=aHR0cHM6Ly95b3Vyc2l0ZS5jb20vcGF5bWVudF9jYWxsYmFjay5waHA/X3hmUHJvdmlkZXI9YnRjUGF5U2VydmVy
4. Under “Which events should trigger this webhook?”,
   choose Send me specific events.
5. Select the event:
   Invoice — Payment Settled
6. Reveal the value in the Secret field and paste it into your XenForo payment profile.
7. Click Add Webhook.

⚠️ Note: Seeing a 403 during webhook tests is normal and won’t affect production.

Click to expand...

4️⃣ Store ID & Final Settings​

1. In BTCPay Server, open Settings.
2. Copy your Store ID.
3. Paste it into the BTCPay payment profile in XenForo.
4. Click Save.

---

✅ Usage​

You can now use this payment profile anywhere XenForo supports payments. For example, to enable it for User Upgrades:

1. Open the XenForo admin panel.
2. Go to Users > User upgrades.
3. Open the relevant upgrade plan.
4. Select your BTCPay Server payment profile.
5. Click Save.