Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in

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:

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
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/balance_settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "payments[payouts][schedule][interval]"=weekly \
  -d "payments[payouts][schedule][weekly_payout_days][]"=monday \
  -d "payments[payouts][schedule][weekly_payout_days][]"=wednesday

Offer faster payouts

Marketplaces often pay out to merchants 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 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

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

Next, learn how to handle refunds and disputes.