Complete a withdrawal request flow
This guide walks through the full withdrawal path — balance review, bank account readiness, withdrawal request, status tracking, and payout confirmation. Read set up bank accounts and withdrawals first for concepts.
Only users with finance permissions can request withdrawals. If a request is blocked, see troubleshoot blocked withdrawals or bank account rejected.
Part 1 — Prepare (before requesting)
- Confirm you are in the correct business workspace.
[Screenshot: App header — active business name and workspace switcher visible.]
- Open Finance and review available, pending, and total balance.
[Screenshot: Finance balance summary — available, pending, and total cards visible.]
- Confirm funds you want to withdraw are in available balance, not pending.
[Screenshot: Available balance card — amount ready for withdrawal highlighted.]
- Open bank account settings and confirm a default payout account exists.
[Screenshot: Bank accounts list — default account badge visible.]
- Verify holder name, document, and PIX key or bank transfer details match the business registration.
[Screenshot: Bank account detail — holder name and document match registration.]
- Confirm your user role includes permission to create withdrawals.
[Screenshot: Finance permissions — create withdrawal permission enabled for user.]
Part 2 — Request withdrawal
- Open the withdrawal request screen from Finance.
[Screenshot: Finance — Request withdrawal button or action visible.]
- Review the withdrawal amount against available balance.
[Screenshot: Withdrawal form — amount field and available balance shown.]
- Confirm the default payout account is selected.
[Screenshot: Payout account selector — default bank account pre-selected.]
- Submit the withdrawal request.
[Screenshot: Withdrawal submitted — confirmation message or pending status visible.]
- Note the withdrawal request ID or timestamp for tracking.
[Screenshot: Withdrawal history — new request row with pending status.]
Part 3 — Track and confirm
- Open withdrawal history and monitor status changes.
[Screenshot: Withdrawal history — status column shows processing or pending.]
- Compare status against the withdrawal status lifecycle.
[Screenshot: Withdrawal detail — status timeline or current stage visible.]
- When completed, confirm available balance decreased and payout account received funds.
[Screenshot: Completed withdrawal — status shows completed and balance updated.]
- If rejected, open the rejection reason and follow fix a rejected bank account.
[Screenshot: Rejected withdrawal — rejection reason and next-step link visible.]
- Reconcile Dashboard and Finance if stakeholders ask about the payout period.
[Screenshot: Financial Overview — withdrawal period reflected in finance reporting.]
Withdrawal status cheat sheet
| Status | What it means | What to do |
|---|---|---|
| Pending / processing | Request submitted, payout in progress | Wait; check withdrawal status lifecycle |
| Completed | Payout sent to the bank account | Confirm funds arrived; archive for accounting |
| Rejected | Validation or bank details failed | Fix account; see bank account rejected |
| Blocked action | User lacks permission or balance insufficient | Check blocked withdrawals |
Common mistakes
- Requesting withdrawal from pending balance instead of available.
- Using a bank account with holder name mismatch vs business registration.
- Requesting withdrawal without finance user permissions.
- Ignoring rejection reason and retrying without fixing account details.
FAQ
Why is my balance pending after approved sales?
Approved sales may sit in pending balance during settlement timelines and payout delay. Only available balance can be withdrawn.
Can I change the payout account after submitting?
Depends on withdrawal status. If still pending, cancel or contact support per your workflow. Fix the default account before the next request.