Help for owners
Stripe Connect accounts are stuck in verification and cannot get paid
Short answer
Each connected account must give Stripe the identity and business details its country and capabilities require. Items listed as currently due must be resolved before a deadline, or payouts are typically disabled. Check the account's requirements and any error on them first, then make sure your platform listens for Stripe's account updates.
Does this sound like your situation?
- Sellers on my platform say they completed sign-up but cannot receive payouts.
- An account shows as restricted or has a deadline I did not notice.
- A document was uploaded and the same item came back again.
- Onboarding worked in test mode but real accounts get stuck.
- A payout failed and the bank account on the connected account stopped working.
Why does this happen?
Required information differs for every account
Stripe needs information before it enables charges and payouts, and what it asks for depends on the account's country, its service agreement type and the capabilities requested. The same form can be enough for one seller and not for another.
Confirmed by docs.stripe.com
Items due have deadlines
Items in the currently due list must be resolved by the current deadline to keep the account active. Stripe typically disables payouts if the information does not arrive by then. The past due list holds requirements that have already disabled capabilities.
Confirmed by docs.stripe.com
Verification can fail and come back
Stripe verifies what is submitted and may ask for more. If verification or validation fails, a requirement can reappear as currently due with error details. Items under pending verification are being reviewed and need no action.
Confirmed by docs.stripe.com
The platform has to notice the change
Stripe tells the platform about new requirements through the account.updated event on a Connect webhook. If nothing listens, no one asks the seller for the new item, and the deadline passes.
Confirmed by docs.stripe.com
A failed payout disables the bank account
When a payout fails, Stripe disables the external account involved until the platform updates the connected account's bank details. Stripe also sends events for the failed payout and the disabled account.
Confirmed by docs.stripe.com
What can I do about it today?
- Say which side you are onIf you receive payouts through someone else's platform, Stripe says to contact that platform, because it controls your payout settings. If you run the platform, continue below.
- Open one stuck account in the DashboardLook at its disabled reason and the list of items due. Write down the items and the deadline before touching anything.
- Ask the seller for exactly what is listedSend them the specific missing item, such as a document or a date of birth, by your normal secure channel. Do not collect ID documents by email.
- Separate waiting from brokenItems under pending verification are being reviewed. Re-submitting them will not speed anything up.
- Check the bank accountIf a payout failed, the seller needs to correct the bank details. Do not retry repeatedly.
- Ask your developer about the webhookAsk whether your platform receives Stripe's account updated events and tells sellers what is due.
When should I bring someone in?
- Several accounts are stuck and you cannot say what the same cause is.
- Nobody on your side receives or reads the account updated events.
- You are about to change how sellers are onboarded and cannot test with real verification cases.
How do I handle it?
- Map the statesI read your account data and list how many accounts are in each state: complete, due, past due, pending review, payout failed.
- Read the platform's handlingI check how your code creates accounts, which capabilities it requests and how it reacts to requirement changes and events.
- Test with Stripe's test accountsStripe documents test accounts and verification testing for Connect, so I reproduce each state there before changing live behaviour.
- Tell sellers clearlyI make sure a seller sees in plain words what is needed and by when, instead of a generic restricted notice.
- Make the changes reversibleChanges ship with a rollback, and I do not touch a live connected account without your written agreement.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Why was my seller restricted after being fine?
Stripe says a requirement can become required later, once a threshold is reached, and then it appears as currently due with its own deadline.
Do I need to do anything for items under pending verification?
Stripe says no action is required while they are being verified. A failed verification moves the item back to a due list.
Can I fix a seller's account on their behalf?
In some cases a platform can provide extra information for a connected account, or generate a link to an appeal form. Stripe's page says it depends on the disabled reason.
Why did the seller's bank account stop working?
After a failed payout Stripe disables the external account until the platform updates its details.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.