Payouts to connected accounts

By default, any charge you make on behalf of a connected account accumulates in the connected account’s balance and is paid out on a daily rolling basis. Depending on the configuration of your connected accounts, your platform can manage their payouts as follows:

• Schedule the frequency of automatic payouts
• Perform manual payouts
• Settle funds instantly
• When using destination charges or separate charges and transfers, retain funds in your platform balance

Payout management configurations

For connected accounts with access to the full Stripe Dashboard or Express Dashboard, the account holder manages their external payout accounts (bank accounts and debit cards), but the platform can schedule payouts. To schedule payouts for an account that has access to the full Stripe Dashboard, the platform must configure Platform controls for the account.

For connected accounts without access to a Stripe-hosted Dashboard, the platform manages their external payout accounts and can schedule their payouts.

Supported settlement currencies

To see which currencies you can use to settle funds in a particular country, select that country from the following dropdown.

Platforms can also enable their connected accounts to settle funds and pay out to banks in certain non-primary currencies, or pay out to non-domestic bank accounts in the local currency. In some cases, Stripe charges a fee. For more information, see multi-currency settlement for Connect marketplaces and platforms.

Payout status

The Payout object’s status field reflects where funds are in the payout lifecycle:

• pending: The payout has been created and is waiting to be submitted to the bank. Funds haven’t left Stripe yet.
• in_transit: Funds have been submitted to the bank and are on their way to the external account.
• paid: The payout has arrived at the external account. For standard payouts, this typically occurs 1–2 business days after submission.
• failed: The payout couldn’t be completed. The Payout object’s failure_code property indicates the reason. When a payout fails, the external account involved is disabled and can’t receive payouts until the platform updates the connected account’s external account details.
• canceled: The payout was canceled before funds were submitted to the bank.

For most payouts, the full lifecycle takes several days. Instant payouts typically reach the account within 30 minutes.

If a connected account holder isn’t seeing expected funds, they need to contact the platform they work with—the platform controls payout settings and schedules for their connected accounts.

Track payouts with webhooks

You can track all payout activity on connected accounts by creating an event destination and listening for these events:

• payout.created: Sent when a payout is created (status: pending).
• payout.updated: Sent when payout details change, such as the estimated arrival date.
• payout.paid: Sent when the payout reaches the external account (status: paid).
• payout.failed: Sent when a payout fails (status: failed). Stripe also sends an account.external_account.updated event because the failed external account is disabled.

Next steps

• Manage payout schedules
• Create manual payouts
• Enable instant payouts
• Manage external accounts for connected accounts