Pay out to connected accounts

Handle payouts to your marketplace's 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, you can manage their payouts as follows:

Schedule the frequency of automatic payouts
Perform manual payouts
Settle funds instantly
Retain funds in your platform balance when using destination charges or separate charges and transfers

Payout timing

By default, any funds that you transfer to a connected account accumulate in the connected account’s Stripe balance and are paid out on a daily rolling basis. To change the payout frequency for a connected account:

On the connected account’s details page, click the overflow menu () in the Account balances section.
Select Edit payout schedule.
Make your selection, then click Save.

Offer faster payouts

It’s common for marketplaces to offer faster payouts to merchants. One way to speed up payout timing is to offer Instant Payouts. With Instant Payouts, marketplaces can allow their users to access their balances immediately following a successful charge. Instant Payouts are available at any day or time, including weekends and holidays, and funds typically settle in the associated bank account within 30 minutes. You can use Instant Payouts to attract and retain new users and to realize additional revenue by assessing a fee.

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

Select a country from the following dropdown to see the currencies you must pay out funds in when your connected account’s external bank account is in that country.

Note

For a list of supported presentment currencies, see the currencies documentation.

Loading a table of connect payout currencies

You can also enable your 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.

Track payouts with webhooks

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

payout.created
payout.updated
payout.paid
payout.failed

For most payouts, event notifications occur over a series of days. Instant payouts typically send payout.paid within 30 minutes.

When a payout can’t be completed, a payout.failed event occurs. The event’s failure_code property indicates the reason. A failed payout also disables the external account involved in that payout, triggering an account.external_account.updated event. No payouts can be made to that external account until the platform updates the connected account’s external accounts.

Next steps

Next, learn how to handle refunds and disputes.