disable automatic payouts and manually funding connected accounts

[Igor Shmukler]

Hello,

I am using Express "connected accounts" for processing transactions in
my marketplace. Currently, captured funds are transferred to the
connected accounts as soon as funds are available. I want to
completely disable this. I don't want to specify the delay after which
funds are transferred automatically. Instead, my nightly batch job
will figure out how much to transfer to each account. Hence my
questions:

1. how do I disable automatic payouts for connected accounts?
2. how do I, using Stripe API, transfer the desired amount, or perhaps
fund qualified payment intents one at a time? [as in once payments
pi_1 and pi_2 qualify for payouts, my batch job tells stripe to do
payouts for those two payments]

Thank you

[Remi J.]

Hello Igor,

As a platform you can control the Payout schedule of your connected accounts easily via the API. This is documented in details in this doc: https://stripe.com/docs/connect/payouts#payout-schedule

Overall, you would pass `settings[payouts][schedule][interval]: 'manual'` in the API [1] to indicate that you want to accumulate the balance in that account over time and not pay out the funds automatically. Then, when you're ready to send the funds to their bank account, you would use the Create Payout API [1]. You would indicate the connected account that you are making the request on behalf of using the `Stripe-Account` header [3]. When creating manual Payouts, you have full control around when to send the money and how much to send. You wouldn't be able to link a specific Payout to a specific list of PaymentIntents in Stripe. You'd simply pay out $270 for example and track on your end that those funds are for 3 PaymentIntents where you sent $90 each for that account.

Hope this helps!

Remi

[1] https://stripe.com/docs/api/accounts/create#create_account-settings-payouts-schedule-interval

[2] https://stripe.com/docs/api/payouts/create

[3] https://stripe.com/docs/connect/authentication#authentication-via-the-stripe-account-header

--
To unsubscribe from this group and stop receiving emails from it, send an email to api-discuss...@lists.stripe.com.

[Igor Shmukler]

Hello Remi,

Thank you for the information.

Does this mean that I could create accounts as below:

const account = await stripe.accounts.create({
country: 'US',
type: 'express',
capabilities: {
card_payments: {
requested: true
},
transfers: {
requested: true
}
},

settings: {
payouts: {
schedule: {
interval: 'manual'
}
}
}

});

Would that take care of automatic payouts being disabled for the
accounts created as above?

Thank you

[Remi J.]

Hello Igor,

That's correct. With that configuration the account would have funds simply accumulate in their balance in Stripe and funds would never be paid automatically. You would then be able to trigger the Payout creation when you're ready to send part of (or all) the funds out to their bank account (or debit card in the US).

Hope this helps!

Remi

[Igor Shmukler]

Awesome. It does help. Thank you.

On Fri, Feb 19, 2021 at 1:15 PM 'Remi J.' via Stripe API Discussion