# Pay out to connected accounts

Handle payouts to your marketplace's connected accounts.

By default, any [charge](https://docs.stripe.com/connect/charges.md) you make on behalf of a connected account accumulates in the connected account’s [balance](https://docs.stripe.com/connect/account-balances.md) and is paid out on a daily rolling basis. Depending on the configuration of your connected accounts, you can manage their *payouts* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) as follows:

- Schedule [the frequency of automatic payouts](https://docs.stripe.com/connect/manage-payout-schedule.md)
- Perform [manual payouts](https://docs.stripe.com/connect/manual-payouts.md)
- Settle funds [instantly](https://docs.stripe.com/connect/instant-payouts.md)
- Retain funds in your platform balance when using [destination charges](https://docs.stripe.com/connect/destination-charges.md) or [separate charges and transfers](https://docs.stripe.com/connect/separate-charges-and-transfers.md)
- Configure [minimum balances for automatic payouts](https://docs.stripe.com/payouts/minimum-balances-for-automatic-payouts.md)

You can use either your Dashboard or the [Balance Settings API](https://docs.stripe.com/api/balance-settings.md).

## Payout timing

By default, any funds that you transfer to a connected account accumulate in the connected account’s [Stripe balance](https://docs.stripe.com/connect/account-balances.md) 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.

#### API

Use the [Balance Settings](https://docs.stripe.com/api/balance-settings.md) API.

```curl
curl https://api.stripe.com/v1/balance_settings \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "payments[payouts][schedule][interval]=weekly" \
  -d "payments[payouts][schedule][weekly_payout_days][]=monday" \
  -d "payments[payouts][schedule][weekly_payout_days][]=wednesday"
```

#### Dashboard

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

> #### 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](https://docs.stripe.com/connect/instant-payouts.md). 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* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) 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](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts.md) 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.

> For a list of supported presentment currencies, see the [currencies](https://docs.stripe.com/currencies.md#presentment-currencies) documentation.
[See table on original page](https://docs.stripe.com/connect/marketplace/tasks/payout)
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](https://docs.stripe.com/connect/multicurrency-settlement.md).

## Track payouts with webhooks 

You can track all payout activity on connected accounts with webhooks by creating an [event destination](https://docs.stripe.com/event-destinations.md) 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](https://docs.stripe.com/connect/marketplace/tasks/refunds-disputes.md).