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
Configure minimum balances for automatic payouts

You can use either your Dashboard or the Balance Settings API.

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. You can configure your connected account’s payout frequency using either your Dashboard or the API.

Use the Balance Settings API.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

.NET

No results

Offer faster payouts

Marketplaces often pay out to businesses more frequently. You can allow your connected accounts to access their balances immediately following a successful charge by offering Instant Payouts. 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 realize additional revenue by assessing a fee for receiving Instant Payouts.

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.

Accounts v2 API

The Accounts v2 API doesn’t directly support the external_accounts hash. When using v2, use /v1/accounts endpoints to manage external_accounts.

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 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

Accounts v2 API

Payouts don’t trigger v2 events. They only trigger the v1 events described here.

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

After you can make payouts to your connected accounts, configure how to handle refunds and disputes.