Using manual payouts

Sending manual payouts to your Custom and Express connected accounts

If you set the value of settings[payouts][schedule] to manual using the Accounts API, Stripe will hold funds in the account holder’s balance until told to pay them out for up to 90 days. The exception to this limitation is the U.S., where funds can be held in their balance for up to two years. To trigger a payout of these funds, use the Payouts API.

The Payouts API is only for moving funds from a connected Stripe account’s balance into their external account. To move funds between the platform and a connected account, see creating separate charges and transfers or creating destination charges through the platform.

Regular payouts

As a basic payout example, to have $10 sent from a connected account’s Stripe balance to their external account:

curl https://api.stripe.com/v1/payouts \
  -u {PLATFORM_SECRET_KEY}: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d amount=1000 \
  -d currency=usd
curl https://api.stripe.com/v1/payouts \
  -u {PLATFORM_SECRET_KEY}: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d amount=1000 \
  -d currency=usd

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

payout = Stripe::Payout.create({
  amount: 1000,
  currency: 'usd',
}, {
  stripe_account: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
})
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

payout = Stripe::Payout.create({
  amount: 1000,
  currency: 'usd',
}, {
  stripe_account: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

payout = stripe.Payout.create(
  amount=1000,
  currency='usd',
  stripe_account='{{CONNECTED_STRIPE_ACCOUNT_ID}}',
)
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

payout = stripe.Payout.create(
  amount=1000,
  currency='usd',
  stripe_account='{{CONNECTED_STRIPE_ACCOUNT_ID}}',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$payout = \Stripe\Payout::create([
  'amount' => 1000,
  'currency' => 'usd',
], [
  'stripe_account' => '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
]);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$payout = \Stripe\Payout::create([
  'amount' => 1000,
  'currency' => 'usd',
], [
  'stripe_account' => '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

PayoutCreateParams params =
  PayoutCreateParams.builder()
    .setAmount(1000L)
    .setCurrency("usd")
    .build();

RequestOptions requestOptions =
  RequestOptions.builder()
    .setStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")
    .build();

Payout payout = Payout.create(params, requestOptions);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

PayoutCreateParams params =
  PayoutCreateParams.builder()
    .setAmount(1000L)
    .setCurrency("usd")
    .build();

RequestOptions requestOptions =
  RequestOptions.builder()
    .setStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")
    .build();

Payout payout = Payout.create(params, requestOptions);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create({
  amount: 1000,
  currency: 'usd',
}, {
  stripe_account: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
});
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create({
  amount: 1000,
  currency: 'usd',
}, {
  stripe_account: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.PayoutParams{
  Amount: stripe.Int64(1000),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
}
params.SetStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")

po, _ := payout.New(params)
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.PayoutParams{
  Amount: stripe.Int64(1000),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
}
params.SetStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")

po, _ := payout.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new PayoutCreateOptions
{
  Amount = 1000,
  Currency = "usd",
};

var requestOptions = new RequestOptions();
requestOptions.StripeAccount = "{{CONNECTED_STRIPE_ACCOUNT_ID}}";

var service = new PayoutService();
var payout = service.Create(options, requestOptions);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new PayoutCreateOptions
{
  Amount = 1000,
  Currency = "usd",
};

var requestOptions = new RequestOptions();
requestOptions.StripeAccount = "{{CONNECTED_STRIPE_ACCOUNT_ID}}";

var service = new PayoutService();
var payout = service.Create(options, requestOptions);

With a standard payout, you can move an amount up to the user’s available balance. To find that amount, perform a retrieve balance call on their behalf.

Stripe tracks balance contributions from different payment sources in separate balances. The retrieve balance response breaks down the components of each balance by source type. For example, to create a payout specifically for a non-credit-card balance, specify the source_type in your request.

curl https://api.stripe.com/v1/payouts \
  -u {PLATFORM_SECRET_KEY}: \
  -d amount=24784 \
  -d currency=usd \
  -d source_type=bank_account
curl https://api.stripe.com/v1/payouts \
  -u {PLATFORM_SECRET_KEY}: \
  -d amount=24784 \
  -d currency=usd \
  -d source_type=bank_account

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Payout.create({
  amount: 24784,
  currency: 'usd',
  source_type: 'bank_account',
})
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Payout.create({
  amount: 24784,
  currency: 'usd',
  source_type: 'bank_account',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

stripe.Payout.create(
  amount=24784,
  currency='usd',
  source_type='bank_account',
)
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

stripe.Payout.create(
  amount=24784,
  currency='usd',
  source_type='bank_account',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

\Stripe\Payout::create([
  'amount' => 24784,
  'currency' => 'usd',
  'source_type' => 'bank_account'
]);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

\Stripe\Payout::create([
  'amount' => 24784,
  'currency' => 'usd',
  'source_type' => 'bank_account'
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

PayoutCreateParams params =
  PayoutCreateParams.builder()
    .setAmount(24784L)
    .setCurrency("usd")
    .setSourceType(PayoutCreateParams.SourceType.BANK_ACCOUNT)
    .build();

Payout payout = Payout.create(params);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

PayoutCreateParams params =
  PayoutCreateParams.builder()
    .setAmount(24784L)
    .setCurrency("usd")
    .setSourceType(PayoutCreateParams.SourceType.BANK_ACCOUNT)
    .build();

Payout payout = Payout.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create({
  amount: 24784,
  currency: 'usd',
  source_type: 'bank_account',
});
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create({
  amount: 24784,
  currency: 'usd',
  source_type: 'bank_account',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.PayoutParams{
  Amount: stripe.Int64(1100),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
  SourceType: stripe.String(string(stripe.PayoutSourceTypeBankAccount)),
}
po, _ := payout.New(params)
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.PayoutParams{
  Amount: stripe.Int64(1100),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
  SourceType: stripe.String(string(stripe.PayoutSourceTypeBankAccount)),
}
po, _ := payout.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new PayoutCreateOptions
{
  Amount = 1100,
  Currency = "usd",
  SourceType = "bank_account",
};

var service = new PayoutService();
var payout = service.Create(options);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new PayoutCreateOptions
{
  Amount = 1100,
  Currency = "usd",
  SourceType = "bank_account",
};

var service = new PayoutService();
var payout = service.Create(options);

Note that it is possible for any source’s balance component to go negative (through refunds or chargebacks), and payouts can’t be created for greater than the aggregate available balance.