Instant Payouts

Send Instant Payouts to your connected accounts

Instant Payouts

With Instant Payouts, you can immediately send funds to a connected account’s debit card. You can request Instant Payouts 24/7, including weekends and holidays, and funds typically appear in the associated bank account within 30 minutes.

Coverage

Instant Payouts is generally available in Canada, Singapore, and the United States. If your platform account is based in a different country but you would like to get access to Instant Payouts for Connected Accounts based in these countries, please get in touch.
Instant Payouts is in private beta in the United Kingdom—you can request an invite. If you would like access to Instant Payouts in another country, let us know.

Compatibility

You must add a supported debit card to the connected account to use Instant Payouts. When you add a card to an account, Stripe returns the available_payout_methods property in the response, which contains the set of payout methods Stripe supports for that card. Only values in this set should be passed as the method when creating a payout.

{
  "id": "card_9CUH5DBY1jTgQ0",
  "object": "card",
  ...
  "account": "acct_1032D82eZvKYlo2C",
  "available_payout_methods": ["standard", "instant"],
}
{
  "id": "card_9CUH5DBY1jTgQ0",
  "object": "card",
  ...
  "account": "acct_1032D82eZvKYlo2C",
  "available_payout_methods": ["standard", "instant"],
}

Creating an Instant Payout

You can check a connected accounts’ balance available for payout with the Balances API and the connected account’s API key:

curl https://api.stripe.com/v1/balance \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "Stripe-Account: CONNECTED_STRIPE_ACCOUNT_ID"
curl https://api.stripe.com/v1/balance \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "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'

balance = Stripe::Balance.retrieve(
  {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'

balance = Stripe::Balance.retrieve(
  {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'

balance = stripe.Balance.retrieve(
  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'

balance = stripe.Balance.retrieve(
  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');

$balance = \Stripe\Balance::retrieve(
  ['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');

$balance = \Stripe\Balance::retrieve(
  ['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";

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

Balance balance = Balance.retrieve(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";

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

Balance balance = Balance.retrieve(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');
const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const balance = await stripe.balance.retrieve({
  stripeAccount: '{{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');
const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const balance = await stripe.balance.retrieve({
  stripeAccount: '{{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.BalanceParams{}
params.SetStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")
bal, _ := balance.Get(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.BalanceParams{}
params.SetStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")
bal, _ := balance.Get(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 requestOptions = new RequestOptions();
requestOptions.StripeAccount = "{{CONNECTED_STRIPE_ACCOUNT_ID}}";
var service = new BalanceService();
Balance balance = service.Get(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 requestOptions = new RequestOptions();
requestOptions.StripeAccount = "{{CONNECTED_STRIPE_ACCOUNT_ID}}";
var service = new BalanceService();
Balance balance = service.Get(requestOptions);

The response contains an instant_available balance representing the amount the account can pay out instantly:

{
  "object": "balance",
  "instant_available": [
    {
      "amount": 10000,
      "currency": "usd",
      "source_types": {
        "card": 10000
      }
  ]
}
{
  "object": "balance",
  "instant_available": [
    {
      "amount": 10000,
      "currency": "usd",
      "source_types": {
        "card": 10000
      }
  ]
}

To create an Instant Payout, specify instant for the method property when creating the payout:

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

# 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',
  method: 'instant',
}, {
  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',
  method: 'instant',
}, {
  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',
  method='instant',
  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',
  method='instant',
  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',
  'method' => 'instant',
], [
  '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',
  'method' => 'instant',
], [
  '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")
    .setMethod(PayoutCreateParams.Method.INSTANT)
    .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")
    .setMethod(PayoutCreateParams.Method.INSTANT)
    .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');
const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create({
  amount: 1000,
  currency: 'usd',
  method: 'instant',
}, {
  stripeAccount: '{{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');
const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create({
  amount: 1000,
  currency: 'usd',
  method: 'instant',
}, {
  stripeAccount: '{{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(1100),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
  Method: stripe.String(string(stripe.PayoutMethodInstant)),
}
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(1100),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
  Method: stripe.String(string(stripe.PayoutMethodInstant)),
}
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",
  Method = "instant",
};

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",
  Method = "instant",
};

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

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

Initially, platforms can pay out up to $5,000 USD per day—in total, across all connected accounts—through Instant Payouts. Each day resets at 12am CST. Contact us if you need to increase this threshold.