- Understanding the marketplace wallet concept
- Why the wallet system is important
- When earnings are added to the store wallet
- Understanding pending wallet balance
- Understanding the clearance period
- Why clearance periods are important
- Understanding available wallet balance
- Minimum payout threshold
- Minimum wallet reserve
- Understanding payout disbursement
- Manual payouts
- Automatic payouts
- Understanding withdrawal request approval
- Understanding withdrawal fees
- Understanding payout methods
- How the complete earning lifecycle works
- Recommended setup for new marketplaces
- Final thoughts
Once marketplace commission and deductions are calculated, the remaining store earnings move through the wallet system before stores can receive payouts.
The wallet system acts like a virtual balance manager for store earnings inside your marketplace.
Instead of sending money directly to stores immediately after every order, MultiVendorX temporarily manages the earnings inside a wallet system first.
This wallet system helps marketplaces:
- Manage pending earnings
- Handle refunds safely
- Control payout timing
- Maintain payout stability
- Automate store disbursement
Understanding how the wallet system works is important because every store payout depends on it.
This document explains how store earnings move from completed orders to final payouts in MultiVendorX.
Understanding the marketplace wallet concept #
The store wallet is a virtual balance system inside MultiVendorX.
It does not directly hold money inside your website.
Instead, it works as an accounting layer that tracks:
- Store earnings
- Pending balances
- Available balances
- Withdrawals
- Payout history
Think of the wallet like a temporary holding account for store earnings.
Whenever a customer places an order:
- MultiVendorX calculates the store earning
- The earning gets tracked inside the wallet
- The system decides when the earning becomes payable
This gives marketplace admins better financial control before releasing payouts.
Why the wallet system is important #
Without a wallet system, marketplaces would need to manually calculate and release earnings for every order.
The wallet system automates this process safely.
It also protects marketplaces against:
- Refund requests
- Chargebacks
- Payment disputes
- Fraudulent transactions
- Premature withdrawals
This is why most professional marketplaces use delayed wallet-based payout systems instead of instant payouts.
Store wallet earning flow #
Customer places order
↓
Marketplace commission gets calculated
↓
Store earning is generated
↓
Order reaches eligible payout status
↓
Earning moves to pending wallet balance
↓
Clearance period completes
↓
Earning becomes available for payout
↓
Store receives payout
This process helps marketplaces protect against:
- Refunds
- Cancellations
- Payment disputes
- Failed transactions
When earnings are added to the store wallet #
Store earnings are added to the wallet only after the order reaches eligible payout statuses.
You can configure eligible statuses from:
Settings → Finance → Wallet
Marketplace admins can choose which order statuses should release store earnings into the wallet.
Common payout statuses #
- Completed
- Delivered
- Processing
- Shipped
This gives marketplaces flexibility depending on their order fulfillment process.
Understanding pending wallet balance #
When an order becomes eligible for payout, the earning does not immediately become withdrawable.
Instead, it first moves into the pending wallet balance.
Pending balance acts as a temporary holding area before the funds become available to the store.
This protects the marketplace against:
- Customer refund requests
- Order cancellations
- Chargebacks
- Disputes
Understanding the clearance period #
The clearance period controls how long earnings remain in the pending balance before becoming available for withdrawal.
You can configure this from:
Settings → Finance → Wallet
Example #
If the clearance period is set to 7 days:
- The order completes today
- Store earning enters pending balance
- Funds become available after 7 days
This delay gives the marketplace enough time to handle potential order issues safely.
Why clearance periods are important #
Many new marketplace owners skip clearance periods in the beginning.
However, clearance periods are extremely important for marketplace stability.
They help protect against:
- Refund abuse
- Fraudulent transactions
- Early withdrawals before disputes
- Payment reversals
Most marketplaces use a clearance period between:
- 7 days
- 14 days
- 30 days
depending on the business model.
Understanding available wallet balance #
Once the clearance period ends, the pending earning automatically moves into the available wallet balance.
Available balance means:
- The earning is now cleared
- The store can request withdrawal
- Automatic payouts can process the amount
This is the actual withdrawable earning visible to stores.
Minimum payout threshold #
Marketplace admins can set a minimum wallet balance before stores become eligible for payouts.
This prevents very small withdrawal requests.
Example #
If the minimum payout threshold is $100:
- A store with $40 cannot withdraw yet
- A store with $120 becomes eligible for payout
This helps marketplaces reduce operational payout overhead.
Minimum wallet reserve #
MultiVendorX also allows marketplaces to keep a fixed reserve amount inside the store wallet.
This reserve amount cannot be withdrawn.
Example #
If the reserve amount is $50:
- Wallet balance = $200
- Withdrawable amount = $150
This reserve helps marketplaces maintain financial safety buffers.
Understanding payout disbursement #
Once earnings become available, MultiVendorX can disburse payouts in two different ways:
- Manual payout
- Automatic payout
You can configure this from:
Settings → Finance → Wallet
Manual payouts #
If manual payout is enabled:
- Stores must request withdrawals manually
- Admin reviews the request
- Admin manually releases payment
This gives the marketplace full control over payout approval.
Commonly used for #
- New marketplaces
- High-risk marketplaces
- Manual verification workflows
Automatic payouts #
If automatic payout scheduling is enabled, MultiVendorX automatically disburses store earnings based on your selected payout frequency.
Available payout schedules #
- Hourly
- Daily
- Weekly
- Fortnightly
- Monthly
This reduces manual payout management for marketplace admins.
Understanding withdrawal request approval #
For manual withdrawal systems, MultiVendorX allows different approval workflows.
Automatic approval #
If Stripe Connect or PayPal Payout is used:
- Withdrawal requests can be approved automatically
- Funds transfer instantly to the store account
This creates a seamless payout experience.
Manual approval #
In this setup:
- Stores submit withdrawal requests
- Admin reviews the request
- Admin manually releases payment
This gives marketplaces additional verification control.
Block withdrawals #
If withdrawal requests are blocked:
- Stores cannot request payouts themselves
- Marketplace admins fully control payout release
This model is usually used in highly controlled marketplaces.
Understanding withdrawal fees #
Marketplaces can also charge withdrawal processing fees.
This helps discourage very frequent small withdrawals.
You can configure:
- Number of free withdrawals
- Fixed withdrawal fee
- Percentage withdrawal fee
Example #
- First 2 withdrawals are free
- Third withdrawal applies a fee
If a withdrawal fee exists:
- The fee is deducted before payout
- Final store payout becomes lower
Understanding payout methods #
MultiVendorX supports multiple payout methods for store disbursement.
Marketplace admins can enable or disable payout integrations depending on business requirements.
Supported payout methods #
- Bank transfer
- Stripe Connect
- PayPal Payout
- Cash payout
- Custom payout gateways
The selected payout method controls how stores finally receive their earnings.
Detailed payout method configuration is covered in separate payout documentation.
How the complete earning lifecycle works #
By now, the complete marketplace earning flow should look easier to understand.
Complete earning lifecycle #
Customer places order
↓
Marketplace commission gets calculated
↓
Taxes and deductions apply
↓
Store earning gets generated
↓
Order reaches payout status
↓
Earning enters pending balance
↓
Clearance period completes
↓
Funds become available in wallet
↓
Withdrawal or automatic payout processes
↓
Store receives final payout
This is the complete earning journey inside MultiVendorX.
Recommended setup for new marketplaces #
If you are launching a new marketplace, start with a simple wallet setup.
Recommended beginner setup #
- Completed order status for payouts
- 7-day clearance period
- Manual payouts initially
- Basic minimum payout threshold
This gives marketplace admins better control during the early growth stage.
As the marketplace grows, you can gradually introduce:
- Automatic payouts
- Faster payout schedules
- Advanced payout workflows
- Automated withdrawal approvals
Final thoughts #
The wallet system is the core financial control layer of your marketplace.
Once you understand:
- How earnings move through the wallet
- Why pending balances exist
- How payouts are released
- How clearance periods work
it becomes much easier to manage marketplace payouts safely and efficiently.
Starting with a simple payout workflow is usually the best approach for new marketplaces.
