Troubleshoot blocked withdrawals
Withdrawal blocks usually come from balance availability, bank account validation, permissions, or incomplete business setup. They often appear when finance expects Dashboard sales to be immediately withdrawable, but settlement timing and payout delay work on different schedules.
Use this guide when a withdrawal cannot be submitted, is rejected, or remains blocked after request.
Common causes
| Cause | What to check |
|---|---|
| Insufficient available balance | Pending funds are not withdrawable yet |
| Bank account incomplete or rejected | Account details and holder match. See bank account rejected. |
| Missing finance permission | User role cannot create withdrawals. See finance permissions. |
| Incomplete company registration | Business finance setup still unfinished |
| Validation error on request | Amount, account, or business rules |
| Wrong business workspace | Balance belongs to another entity |
Blocked withdrawals are often explainable once available balance, account status, and permissions are reviewed together.
What withdrawals depend on
| Dependency | Why it matters |
|---|---|
| Available balance | Withdrawals use available funds, not pending balance |
| Settlement timing | Recent approved sales may not yet be withdrawable |
| Bank account validation | Holder and account details must match registration |
| Registration type | Individual and company payout rules differ |
| User permissions | Not every finance viewer can create withdrawals |
| Withdrawal status lifecycle | Rejected requests need root-cause fixes before retry |
Investigation workflow
- Confirm the correct business workspace.
[Screenshot: App header — correct business workspace selected.]
- Open Finance and review available versus pending balance.
[Screenshot: Finance balance cards — available vs pending amounts visible.]
- Compare recent Sales with balance movement using reconcile Dashboard and Finance if needed.
[Screenshot: Sales and Finance comparison — recent sales vs withdrawable balance.]
- Check default bank account status and details.
[Screenshot: Default bank account row — status and holder details visible.]
- Review whether the account was rejected or incomplete.
[Screenshot: Bank account status — rejected or incomplete indicator visible.]
- Confirm the user has permission to create withdrawals.
[Screenshot: User permissions — create withdrawal permission enabled or missing.]
- Review company registration and finance completeness.
[Screenshot: Company registration — finance setup completeness checklist.]
- Read the exact validation or rejection message on the withdrawal attempt.
[Screenshot: Withdrawal error message — validation or rejection reason displayed.]
- Fix the root cause before retrying.
[Screenshot: Bank account or balance fixed — withdrawal action enabled again.]
- Collect error message, date, amount, and account context before escalation.
[Screenshot: Escalation ticket — error details and context documented.]
What to explain to finance stakeholders
| Question | How to answer it |
|---|---|
| Why is withdrawal unavailable? | Available balance, account status, or permissions |
| Did we lose the money? | Check refunds, chargebacks, and fees first |
| Can we retry today? | Only after the root cause is fixed |
| Why is balance pending? | See settlement timelines and fees and payout delay |
Best practices
- Explain pending balance before the first withdrawal attempt.
- Verify bank account holder matches registration type.
- Restrict withdrawal creation to trusted roles using finance permissions.
- Track withdrawal history during the first payout cycles.
- Fix rejected bank accounts before repeated withdrawal retries.
Common mistakes
- Requesting withdrawals from pending balance.
- Retrying withdrawal without fixing bank account rejection.
- Using finance data from the wrong workspace.
- Assuming every approved sale is immediately withdrawable.
- Giving every finance viewer permission to create payouts.
FAQ
Is blocked withdrawal the same as rejected withdrawal?
They are related. A request may be blocked before submission or rejected after submission. Review withdrawal status lifecycle.
Where do I set up the payout account?
Can chargebacks block withdrawals?
Balance changes from chargebacks and refunds can reduce available funds unexpectedly.