[XB] Withdrawal Queue 2.2.0

Manage manual XenForo withdrawals with a moderated payout queue, reusable user wallets, configurable payment systems, and forum currency integration.

Members can submit withdrawal requests from their accounts, while authorized staff review each request, record payout details, attach proof, and maintain a permanent operation history.

---

Features:​

Withdrawal Requests​

• Member Withdrawal Requests: Let members choose a saved wallet, enter an amount, review the calculated charge and payout, and submit a request.
• Personal Withdrawal History: Give members a responsive list of their requests with status and payment-system filters.
• Detailed Request View: Show the requested amount, payout amount, charged forum currency, destination wallet, status, dates, and public payout information.
• Completion and Rejection Notifications: Notify members through XenForo alerts and push notifications when staff complete or reject a request.

Wallets & Payment Systems​

• Reusable Wallets: Members can add, edit, and delete payout requisites for enabled payment systems.
• Custom Requisite Fields: Administrators can create custom fields and assign them to specific payment systems.
• Wallet Validation: Support text, email, telephone, and Bitcoin address inputs with type-specific validation.
• Optional Wallet Uniqueness: Prevent the same wallet value from being used more than once when uniqueness is enabled.
• Payment System Branding: Add payment-system icons, descriptions, payout currency codes, display order, and availability controls.
• Amount Configuration: Configure minimum and step amounts, decimal precision, exchange rates, fixed fees, and percentage commissions.

Limits & Payout Requirements​

• Per-Request Maximum: Limit the amount a member can request in a single withdrawal.
• Rolling Withdrawal Limits: Set cumulative limits for the previous 24 hours and 30 days.
• Queue and Cooldown Controls: Limit pending requests and require a delay between withdrawals.
• User Group Availability: Make individual payment systems available only to selected user groups.
• Limit Bypass Permission: Allow trusted users to bypass configured payment-system limits.
• Required Payout Details: Require a transaction ID, payment proof, or both before staff can mark a payout as sent.

Moderation & Administration​

• Moderated Payout Queue: Process pending requests through a dedicated public moderation queue or the XenForo Admin control panel.
• Queue Filtering: Filter withdrawals by status, payment system, user, wallet, transaction ID, amount, and date criteria.
• Payout Records: Store transaction IDs, member-visible notes, moderator-only notes, and protected image or PDF payment proof.
• Immutable Operation History: Review creation, update, payout, refund, and refund-failure events for every withdrawal.
• CSV Export: Export filtered withdrawal records for accounting or external processing.
• Payment System Management: Create, enable, disable, edit, delete, and reorder payment systems from the Admin control panel.

Currency & API Integration​

• Forum Currency Charging: Debit the configured forum currency when a withdrawal request is created.
• Automatic Refunds: Return the charged amount when a withdrawal request is rejected.
• Optional Currency Add-ons: Integrates with [DBTech] DragonByte Credits 7 and [BR] Credits.
• REST API: Scoped API endpoints support withdrawal, requisite, and payment-system workflows.

---

Permissions:​

• View Withdrawals: Control access to the withdrawal area and personal request history.
• Create Withdrawals: Control who can manage wallets and submit payout requests.
• Moderate Withdrawals: Allow selected users to access and process the public payout queue.
• Bypass Withdrawal Limits: Exempt trusted users from configured amount, period, pending-request, cooldown, and user-group limits.
• Admin Management: Restrict payment systems, requisite fields, exports, and administrative withdrawal tools with a dedicated admin permission.

---

Requirements:​

• XenForo 2.3.0+
• Currency Integration: [DBTech] DragonByte Credits 7 or [BR] Credits is optional and required only for forum currency charging and refunds.

---

Useful for:​

• Creator and Contributor Payouts: Process manual rewards or revenue-share withdrawals through a controlled queue.
• Virtual Economy Communities: Convert forum credits into manually fulfilled payouts while keeping balance adjustments synchronized.
• Contest and Reward Programs: Give eligible members reusable payout destinations and a clear request history.
• Accounting Workflows: Capture transaction references and proof, preserve an audit trail, and export filtered records to CSV.
• Staff Payout Teams: Separate member submission from moderator processing with permissions, private notes, and configurable requirements.

---

FAQ:​

• Are withdrawals paid automatically through PayPal, a bank, or cryptocurrency network?
  
  No. The add-on manages a manual payout workflow. Staff complete the payment externally and then record its details in XenForo.
• Does the add-on work without a supported currency add-on?
  
  Yes. Wallet and withdrawal management can be used without forum currency charging. DragonByte Credits 7 and [BR] Credits are optional integrations.
• What happens to charged forum currency when a request is rejected?
  
  The add-on attempts to refund the amount through the configured currency integration and records the result in the withdrawal history.
• Can payment proof be viewed by everyone?
  
  No. Payment proof attachments are protected by the withdrawal's view permissions.
• Can different payment systems have different limits?
  
  Yes. Each payment system can define its own amount, rolling-period, pending-request, cooldown, and user-group restrictions.

---

Screenshots:​

Member Withdrawal Workflow​

Wallet Management​

Public Navigation & Moderation​

Admin Configuration​

Admin Queue & Permissions​