Setting bank and debit card payouts
In previous versions of Connect, payouts were known as bank transfers. Refer to the legacy transfers documentation for information about the deprecated transfers
API.
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. However, Stripe offers platforms fine-grained tools to change the payout schedule for connected accounts, as well as tools to accumulate charges in the platform balance.
You can:
- Schedule how frequently funds are automatically paid out
- Perform manual payouts
- Settle funds instantly
For Custom accounts, the platform can also set the destination bank accounts and debit cards. For Express accounts, the account holder handles that.
Supported settlement currencies
Select a specific country to see which currencies you can use to settle in that country. You can find the supported presentment currencies in the currencies documentation. Stripe also enables you to settle and pay out to a domestic bank in select alternative currencies for a fee. To learn more about presenting and settling in alternative currencies, see alternative currencies.
Using webhooks with payouts
All payout activity on connected accounts can be tracked using webhooks. (When using Connect, you should always be using webhooks.) Specific to payouts, you’ll see these events:
payout.created
payout.updated
payout.paid
payout.failed
For most payouts, these event notifications occur over a series of days. Instant Payouts typically send payout.paid
within 30 minutes.
If a payout cannot be completed, a payout.failed
event occurs. The event’s failure_code
property indicates why. Additionally, the external account involved in the payout is disabled, triggering an account.external_account.updated
notification. No automatic or manual payouts can go through until the platform updates the connected account’s external accounts.