[XB] Patreon Integration 1.1.1 Patch Level 1

Connect XenForo user upgrades with Patreon membership tiers.

This add-on syncs Patreon memberships with forum user upgrades and enables signup and upgrade flow through Patreon.

---

Features:​

• Patreon Account Connection: Uses Patreon as a connected account provider.
• Membership Sync: Automatically sync forum user upgrades with Patreon membership tiers.
• Patreon Checkout Redirect: Redirect users to Patreon checkout when purchasing user upgrades.
• Webhook Support: Processes membership updates via Patreon webhooks.
• Webhook Logs: View and track incoming webhook events for debugging and transparency.

---

Useful for:​

• Subscription Monetization: Sync forum access with Patreon tiers.
• Community Supporters: Reward Patreon backers with forum upgrades.
• Automated Access Control: Keep membership and forum permissions in sync.
• Hybrid Payment System: Combine XenForo upgrades with Patreon billing.

---

Setup:​

1. Install the add-on
   • Install [XB] Patreon Integration from ACP -> Add-ons, or upload the add-on files manually to your XenForo installation.
2. Create a Patreon OAuth Client
   • Create a Patreon OAuth client.
   • Set the redirect URL to: https://your-forum.com/connected_account.php
   • Copy the Client ID and Client Secret.
3. Configure the add-on
   • Go to ACP -> Setup -> Options -> [XB] Patreon.
   • Configure:
     • Campaign ID
     • Client Access Token
     • Client Refresh Token
     • Webhook Secret
     • Membership Matching Method
4. Configure Connected Accounts
   • Go to ACP -> Setup -> Connected Accounts -> Patreon.
   • Enter your Client ID and Client Secret.
   • Optionally enable account linking for users.
5. Link Patreon tiers
   • Edit each XenForo user upgrade.
   • Select your Patreon payment profile.
   • Enter the Patreon Tier (Membership) ID.
6. Configure the webhook
   • Create a Patreon webhook with the following URL: https://your-forum.com/patreon_membership_callback.php
   • Subscribe to membership create, update, and delete events.
   • Ensure the webhook secret matches the one configured in the add-on.

---

FAQ:​

1. Users don't receive upgrades
   • Verify the Patreon Tier ID.
   • Check the selected membership matching method.
   • Confirm the Patreon account is linked (when using Patreon User ID matching).
   • Check the Patreon Webhook Log.
   • Run the Patreon Membership Sync cron job manually.
2. Where do I find my Campaign ID?
   • Your Campaign ID is available in your Patreon campaign settings.
3. Can I use multiple Patreon tiers?
   • Yes. Create a separate XenForo user upgrade for each Patreon tier.
4. What happens when a membership expires?
   • The user's upgrade is removed automatically during the next webhook or membership sync.
5. Are gift memberships supported?
   • Yes. The recipient must link their Patreon account to receive the upgrade.
6. Can I sync existing members?
   • Yes. Run the Patreon Membership Sync cron job after completing the setup.
7. How often does the sync run?
   • Memberships are synchronized immediately when a webhook is received.
   • A scheduled cron job also runs once per day by default.
8. When sending a test webhook request, I receive Status code: XXX
   • The correct response code from your web server should be 200.
   • Any other status code usually means the request was rejected by the web server or by the add-on because of an incorrect configuration.
   • Make sure the request is not blocked by your firewall, security rules, or server configuration.
   • Check that the add-on settings match your Patreon credentials.
   • Verify that the webhook secret in Patreon matches the webhook secret configured in the add-on.

---

Screenshots:​