XenForo Integration

The PayzCore XenForo add-on adds USDT/USDC blockchain monitoring as a payment provider for user upgrades and account purchases.

• Source: github.com/payzcore/xenforo
• Requirements: XenForo 2.2+, PHP 7.4+, PayzCore account

How It Works

1. Forum user purchases an upgrade (e.g., Premium membership) and selects "Pay with USDT/USDC".
2. XenForo calls the PayzCore API via the add-on.
3. User sees the wallet address, QR code, amount, and countdown timer.
4. User sends stablecoins from their wallet.
5. PayzCore sends a webhook to the XenForo callback endpoint.
6. Add-on verifies the HMAC signature and applies the user upgrade.
7. User gets premium access automatically.

Installation

1. Download the add-on from GitHub releases
2. Upload the PayzCore folder to src/addons/ in your XenForo installation:

src/addons/PayzCore/
├── Admin/
├── Payment/
├── Callback/
├── addon.json
└── Setup.php

3. In XenForo admin: Add-ons > Install/upgrade from archive or install via CLI:

php cmd.php xf:addon-install PayzCore

Configuration

1. In XenForo admin: Setup > Payment profiles
2. Click Add payment profile
3. Select PayzCore as the provider
4. Configure:

5. When you save the payment profile, the add-on calls GET /api/v1/config to auto-detect available chains and tokens from your connected wallet. The chain and token options are populated automatically — no manual selection is needed.

6. Set your webhook URL in the PayzCore dashboard to:

https://yourforum.com/payment_callback.php?_xfProvider=PayzCore

User Upgrade Flow

1. User goes to Account > Account upgrades
2. Selects an upgrade (e.g., "Premium Member - $10/month")
3. Chooses "PayzCore (USDT/USDC)" as payment method
4. Sees wallet address, QR code, exact amount, and expiration timer
5. Sends stablecoins from their wallet
6. Once confirmed, the upgrade is applied automatically
7. User immediately gets the upgraded user group and permissions

Troubleshooting

Payment provider not available

• Ensure the add-on is installed and active: Add-ons list
• Verify a payment profile is created and enabled
• Check that the payment profile is assigned to at least one user upgrade

Webhook not received

• Verify the callback URL in PayzCore dashboard
• Check XenForo error log: Tools > Logs > Server error log
• Ensure your server allows external POST requests

Upgrade not applied after payment

• Check PayzCore webhook delivery logs
• Verify the Webhook Secret matches
• Check XenForo payment log: Logs > Payment provider log