This add‑on brings two major capabilities that are missing from XenForo’s native payment system:
1. Admin‑Initiated Refunds
Issue full or partial refunds directly from the XenForo admin panel — no need to log into Stripe, PayPal, or any other payment provider dashboard.
2. Smarter Partial Refund Behavior
XenForo’s default behavior incorrectly treats partial refunds as full reversals (for example, refunding $15 on a $30 purchase downgrades the user).
This add‑on fixes that:
•Partial refunds are now logged as informational events and no longer downgrade the user.
•Full refunds continue to trigger automatic downgrades as usual.
In practical terms, the add‑on delivers four core enhancements:1. A Refund Framework for Providers
It introduces a standard interface — supportsRefunds() and refund() — that any payment provider can implement.
It also adds the payment_refund_complete event so purchasable add‑ons can react to refunds appropriately.
2. Provider Enhancements (Stripe & PayPal)
Both the Stripe and PayPal REST providers are extended to include:
•Native refund API calls
•Webhook deduplication
•Correct handling of partial refunds
3. New Admin Interface Elements
A new "Issue Refund" button and refund form are added directly to payment log entries for supported providers.
4. Improved User Upgrade Handling
Since User Upgrades are part of XenForo core, the add‑on integrates enhanced logic:
•Partial refunds no longer force a demotion
•If the admin wants to refund partially and downgrade the user, the UI offers that option
Developers of other add‑ons can enable refund support by implementing:
•supportsRefunds() / refund() on their payment providers
•payment_refund_complete in their purchasable types
How the Refund Process Works (Admin Flow)1.Navigate to Logs → Payment Provider → [specific payment entry]
2.Click "Issue Refund" (only appears for providers that support refunds)
3.Enter the refund amount (automatically pre-filled with the remaining refundable balance)
4.For User Upgrades: choose whether to reverse the purchase (downgrade the user)
5.For other purchasable types: the refund is sent to the payment provider, and the owning add‑on handles any reversal via payment_refund_complete
6.The add‑on calls the provider’s refund API, logs the outcome, and updates the cumulative refunded amount