Last verified: 2026-05-19
Payouts overview (admin)
Monitor merchant payouts, pending settlements, and payout configuration. Page title: Payouts & Settlements — Manage payouts, settlements, and financial transactions.
Dashboard paths
| Area | Route | Page title |
|---|---|---|
| Payouts | /admin/financial/payouts | Payouts & Settlements |
| Payout settings | /admin/financial/payout-settings | Payout Settings |
| Payments | /admin/financial/payments | (Financial hub) |
| Revenue | /admin/financial/revenue | Revenue |
Who can access
| Role | Access |
|---|---|
| Admin | Full (financial.manage, payment.manage) |
| Staff | Only if financial module permissions enabled |
Payouts dashboard metrics
The payouts client shows four summary cards:
| Card | Meaning |
|---|---|
| Total Processed | Sum and count of completed payouts (org currency) |
| Pending Payouts | Amount and count awaiting processing |
| This Month | Current-month payout volume |
| Failed Payouts | Count and amount of failed transfers |
Steps — review payouts
- Open
/admin/financial/payouts(staff: same path when financial permissions allow). - Read the four summary cards: Total Processed, Pending Payouts, This Month, Failed Payouts.
- Scroll Recent Payouts for individual transfer status badges.
- Use Refresh to reload after finance processes a batch.
- Use Process Payouts only when your role and finance SOP allow manual runs.
- Use Export Payouts for accounting reconciliation.
- Use Schedule Payouts to adjust automated payout cadence (if enabled for your org).
If data fails to load, UI shows Unable to Load Payout Data with Try Again.
Steps — payout settings
- Open
/admin/financial/payout-settings. - Connect or verify your payment service provider (PSP) account.
- Confirm bank account details match your legal entity.
- Save; run a small test order and confirm a payout line appears after settlement delay.
Payout settings (/admin/financial/payout-settings)
Configure payout methods and preferences per organization (connected PSP accounts, schedules—exact fields depend on enabled payment integration).
Description: Configure payout methods and preferences for organizations.
How payouts relate to orders
- Customer pays on storefront or POS → payment record (Pending / Paid / Failed / Refunded).
- Platform fees and net amounts roll into payout batches.
- Payouts & Settlements shows transfer status to the merchant bank account.
See Manage orders for refunds that affect settled amounts.
API note (for support engineers)
Admin payouts data is loaded via GET /api/admin/financial/payouts with organizationIds, optional status, date range, and payoutMethod query params. Default window: last 30 days.
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Empty payouts | No paid orders or PSP not connected | Complete payout settings + test order |
| Failed payouts | Bank/PSP rejection | Open failed row; fix account in payout settings |
| Staff cannot see page | Missing financial permission | Admin adjusts staff role |
Related articles
- Set up organization
- Subscription and plan limits
- Superadmin platform payouts — TBD:
superadmin/platform-payouts(internal)
