Troubleshoot rejected bank account details
Rejected bank accounts block withdrawals until payout details match the registered business and pass validation. These rejections are common during first finance setup, especially when registration type and account holder information do not align.
Use this guide when payout details are marked rejected, incomplete, or invalid.
Common causes
| Cause | What to check |
|---|---|
| Holder mismatch | Account holder does not match business registration |
| Incomplete fields | Missing bank, branch, account, or PIX details |
| Wrong account type | Individual versus company payout setup |
| Invalid PIX key | Typo or wrong key type |
| Default account not set | Withdrawal uses incomplete account |
| Wrong workspace | Account added under another business |
Rejection is usually a data mismatch problem, not a temporary payout delay. Compare settlement timing separately if balance is the issue.
What bank validation depends on
| Dependency | Why it matters |
|---|---|
| Individual or company registration | Holder must match legal entity |
| PIX key or bank transfer choice | Wrong method or invalid details fail validation |
| Default account selection | Finance may keep using an incomplete account |
| Business finance completeness | Other setup gaps can block payout readiness |
| User permissions | Finance viewer cannot always fix account details |
Fix workflow
- Confirm the correct business workspace.
[Screenshot: App header — correct business workspace selected.]
- Open finance or bank account settings in Finance.
[Screenshot: Finance bank accounts — rejected or incomplete account visible.]
- Review the rejected or incomplete account record.
[Screenshot: Bank account detail — rejection reason or missing fields shown.]
- Compare holder name and document with business registration.
[Screenshot: Registration vs bank account — holder name and document compared.]
- Decide whether payout should use PIX key or bank transfer details.
[Screenshot: Payout method — PIX key vs bank transfer choice.]
- Correct PIX key or bank transfer details carefully.
[Screenshot: Bank account form — corrected PIX key or transfer details entered.]
- Save and wait for validation if required.
[Screenshot: Account saved — validation pending or in progress.]
- Set the corrected account as default when appropriate.
[Screenshot: Default payout account — corrected account selected.]
- Confirm finance users with the right permissions know the change was made.
[Screenshot: Team permissions — finance users notified of account update.]
- Retry withdrawal only after available balance and validation allow it.
[Screenshot: Withdrawal screen — available balance and validated account ready.]
Holder mismatch examples
| Registration | Common mistake |
|---|---|
| Company business | Personal PIX key or personal account holder |
| Individual business | Company account holder name entered |
| Multi-business login | Correct account added in the wrong workspace |
| Recent migration | Old entity account still on the new business |
What to verify after correction
| Check | Why it matters |
|---|---|
| Account status is no longer rejected or incomplete | Confirms validation progressed |
| Default account points to the corrected record | Prevents repeat failure |
| Holder still matches registration after edit | Rejection can recur from small typos |
| Team does not retry withdrawals repeatedly without changes | Creates unnecessary finance noise |
| Stakeholders understand pending vs available balance | See settlement timelines |
Best practices
- Fix holder mismatch before retrying withdrawal.
- Use one documented default payout account per workspace.
- Have finance review account details during onboarding, not at first payout urgency.
- Pair account fixes with withdrawal status monitoring.
- Document legal entity ownership in multiple business operations.
Common mistakes
- Retrying withdrawal without changing rejected details.
- Entering a valid account for the wrong legal entity.
- Fixing PIX key typos but leaving the old default account selected.
- Assuming rejection means AtomicPay lost the balance.
- Confusing bank rejection with blocked withdrawal caused only by pending balance.
FAQ
Should I use PIX key or bank transfer details?
Can I withdraw while validation is pending?
Usually not safely. Wait for the corrected account to validate before requesting payout again.
Does registration type matter for payout?
Yes. Review choose individual or company registration.
What if withdrawal still fails after bank fix?
See troubleshoot blocked withdrawals for balance, permission, and validation issues.