tanzeel - Connect Payouts | Stripe Developers | Page 1

summer verge Jan 3, 2022, 9:49 PM

#

Hello! It's likely the funds are still in the pending balance, not the available balance. If you fetch the balance via the API you can confirm this.

#

You can use the test card 4000000000000077 to bypass the pending balance in test mode.

sand vine Jan 3, 2022, 9:51 PM

#

i did't get about pending balance

summer verge Jan 3, 2022, 9:51 PM

#

Didn't get what?

sand vine Jan 3, 2022, 9:51 PM

#

what are the balance API ? and what balance api will tell us ?
It will be show the amount of balance in our stripe account ?

summer verge Jan 3, 2022, 9:52 PM

#

It's the Balance API linked in the error message: https://stripe.com/docs/api/balance/balance_retrieve

#

You use that to get details about a Stripe account's balance.

sand vine Jan 3, 2022, 9:52 PM

#

@summer verge can you please help me to understand this

summer verge Jan 3, 2022, 9:53 PM

#

That's the Dashboard, which is not what you want.

#

You need to use the API to see the detail required.

sand vine Jan 3, 2022, 9:53 PM

#

okay just 2 mins i am checking. I am stuck here from last 4 days 😦

summer verge Jan 3, 2022, 9:53 PM

#

We should be able to get you unstuck! Let me know if you have any questions about the Balance API! 🙂

sand vine Jan 3, 2022, 9:55 PM

#

{
"object": "balance",
"available": [
{
"amount": 9063,
"currency": "usd",
"source_types": {
"card": 9063
}
}
],
"connect_reserved": [
{
"amount": 0,
"currency": "usd"
}
],
"livemode": false,
"pending": [
{
"amount": -261,
"currency": "usd",
"source_types": {
"card": -261
}
}
]
}

this is what i got response from balance api

summer verge Jan 3, 2022, 9:56 PM

#

That's your live mode balance. Are you trying to create a Payout in live mode or test mode?

sand vine Jan 3, 2022, 9:56 PM

#

test mode for now.

summer verge Jan 3, 2022, 9:58 PM

#

Can you make the API call again, but using your test secret key instead so you can see your test mode balance?

sand vine Jan 3, 2022, 9:59 PM

#

I am creating the transfer ( charge from user card and transfer funds to particular stripe external account) using this method. Remember we only transfer , payout not created yet.

return await this.stripeClient.transfers.create({
amount,
currency: 'usd',
source_transaction,
destination,
transfer_group: 'ORDER_95',
});

summer verge Jan 3, 2022, 10:01 PM

#

Wait, let's back up a bit.

sand vine Jan 3, 2022, 10:01 PM

#

okay okay

summer verge Jan 3, 2022, 10:02 PM

#

You got the balance from the API, but you got your live mode balance, which has nothing to do with test mode. You need to get your balance in test mode using your test API key.

#

Can you do that and then share your test mode balance details here?

#

Or, wait, maybe I got this wrong!

sand vine Jan 3, 2022, 10:02 PM

#

let me test i guess it is test mode balance but let me confirm again

summer verge Jan 3, 2022, 10:02 PM

#

Nope, nevermind.

#

I'm wrong, sorry.

sand vine Jan 3, 2022, 10:03 PM

#

no worries , liveMode : false is coming. in response

summer verge Jan 3, 2022, 10:03 PM

#

I don't know why I read "livemode": false, as live mode. 😅

sand vine Jan 3, 2022, 10:03 PM

#

hahah it happens to best of us.

summer verge Jan 3, 2022, 10:04 PM

#

Okay, so does the Transfer creation succeed as expected?

#

Or is that where you're getting the error?

sand vine Jan 3, 2022, 10:06 PM

#

Okay so there are two scenarios
when I use this card 4000000000000077 transfer successful and payout also created.

#

But when i use another card lets say 4242424242424242 **balance_insufficient **error occurs

summer verge Jan 3, 2022, 10:07 PM

#

Yep, that's expected. The other test cards are going to put the money in the pending balance, but you can only create a Payout for funds in your available balance.

sand vine Jan 3, 2022, 10:08 PM

#

this will be same in live mode ? if this happens how can i send payout to my external banks/cards

summer verge Jan 3, 2022, 10:09 PM

#

Yep, funds are not immediately available. Have a look here for details: https://stripe.com/docs/payouts#payout-speed

sand vine Jan 3, 2022, 10:10 PM

#

here funds means the "money charge from customer card to stripe account ?

summer verge Jan 3, 2022, 10:11 PM

#

Yes.

sand vine Jan 3, 2022, 10:13 PM

#

Please tell me what should I do. My whole story is i want to create a scenario just like Escrow
1-Customer (Our users in website) will pay the money from card for services.
2- stripe deduct the money and hold this.
3- we (admin ) will have some fee from the charged money (except stripe transaction fee)
4- then send to our service provider( another entity in our website who is giving services)

summer verge Jan 3, 2022, 10:17 PM

#

It sounds like you want manual payouts, although it's worth pointing out that Stripe does not support escrow accounts. See here for more details: https://stripe.com/docs/connect/manual-payouts

sand vine Jan 3, 2022, 10:20 PM

#

One question whenever Payout is created is it means we are going to send the money to his actual external account.

summer verge Jan 3, 2022, 10:20 PM

#

Yeah, Payouts in Stripe are when money moves from a Stripe account to an external account (typically a bank account).

sand vine Jan 3, 2022, 10:22 PM

#

yes i want manual payouts.
So there would be no delays like i want so create payout that should arrive to bank account at 10th date.
what i will do can i add delay days property or something else ?

#

or i have to mange it by my side with the code (lets say cron job or scheduler) so only create payout when 10th date is arrived

summer verge Jan 3, 2022, 10:23 PM

#

Not sure what you're asking... you mentioned both "So there would be no delays" and "what i will do can i add delay days". Do you want no delay or do you want a specific delay?

sand vine Jan 3, 2022, 10:24 PM

#

I want a specific delay for each payouts

summer verge Jan 3, 2022, 10:24 PM

#

You set that on the connected account here: https://stripe.com/docs/api/accounts/update#update_account-settings-payouts-schedule-delay_days

sand vine Jan 3, 2022, 10:29 PM

#

hey @summer verge i have specific events (bookings)
each booking has ending date (like 10 and 14)
when booking ends(completes) i need to send the money (that charged from user before starting date of booking )

so i want to make sure
the payout should release the money on 10th and 14th (not weekly or monthly etc)

Did you get me point ?

summer verge Jan 3, 2022, 10:33 PM

#

That's something you would need to do on your end, where you trigger the manual Payout at the proper time.

sand vine Jan 3, 2022, 10:34 PM

#

so in this way the insufficient balance will never occur because with in 2 days the funds will be available in our stripe right

summer verge Jan 3, 2022, 10:34 PM

#

If that's the amount of time it takes for the funds to become available in your specific scenario, yes.

sand vine Jan 3, 2022, 10:36 PM

#

how can i check funds are available now ?
like i want to send the payout for my service provider and want to send it after 6 days. But how can i check funds are available in my stripe account ?

summer verge Jan 3, 2022, 10:36 PM

#

You fetch the account balance and confirm the amount in the available balance will cover the amount of the Payout.

sand vine Jan 3, 2022, 10:38 PM

#

you mean this balance (that i got from balance api)
"object": "balance",
"available": [
{
"amount": 9063,
"currency": "usd",
"source_types": {
"card": 9063
}
}
],

summer verge Jan 3, 2022, 10:38 PM

#

Yep.

sand vine Jan 3, 2022, 10:40 PM

#

so lets say
i have to send two payouts for 50$
before creating payout i will check i have more than 50$ in my available balance if so then boom send payout. am I right ?

summer verge Jan 3, 2022, 10:40 PM

#

If you want to send two $50 Payouts you would need $100 in the available balance.

sand vine Jan 3, 2022, 10:41 PM

#

YOU HELPED ME A LOT ❤️ BIG THANKS 🙂

THE ONLY LAST QUESTION FROM YOU NOW

#

yes yes sorry 🙂

#

One thing I was checking last night even funds are not available in from charge card to stripe account
But when i create transfer after keeping lets say 15% admin fee(admin means us the site where customer booked events)

i can see the amount in Balances.
like 15% of 14$ is 2.1 after processing fee (0.71 )
1.39$ is added to estimated future payouts

#

1.39 we will keep it appears in future estimated payouts but not the rest like (11.20 $ from 14$)
so 11.20$ was in pending state ?

summer verge Jan 3, 2022, 10:49 PM

#

I recommend you avoid looking at the balances information in the Dashboard and only look at the balance information from the API. The balance info shown in the Dashboard is not detailed enough for your use case and tracking funds at a granular level.

#

You may also want to look at the Balance Transactions API which is a very granular view of what happens to funds moving through your Stripe account: https://stripe.com/docs/api/balance_transactions

sand vine Jan 3, 2022, 10:50 PM

#

Okay perfect

#

Thank you very much ❤️

#

you helped me a lot.

#

I hope now i found what I was looking for. Appreciated your time and effort here 🙂

summer verge Jan 3, 2022, 10:54 PM

#

Happy to help!

sand vine Jan 3, 2022, 10:57 PM

#

@summer verge one minute please

#

{
"object": "balance",
"available": [
{
"amount": 9063,
"currency": "usd",
"source_types": {
"card": 9063
}
}
],
"connect_reserved": [
{
"amount": 0,
"currency": "usd"
}
],
"livemode": false,
"pending": [
{
"amount": -261,
"currency": "usd",
"source_types": {
"card": -261
}
}
]
}

still please check i already have enough balance now

#

if i create payout of 30$ it should create but its not creating 😦

summer verge Jan 3, 2022, 11:01 PM

#

What code are you using to create the Payout?

sand vine Jan 3, 2022, 11:02 PM

#

this one

return await this.stripeClient.payouts.create(
{
amount: parseInt(${amount}),
currency: 'usd',
method: 'standard',
source_type: 'card',
},
{
stripeAccount, // '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
},
);

#

this is image

summer verge Jan 3, 2022, 11:03 PM

#

To clarify, is the balance information above from your platform account or the connected account?

sand vine Jan 3, 2022, 11:03 PM

#

curl --location --request GET 'https://api.stripe.com/v1/balance'
--header 'Authorization: Bearer sk_test_###########'

#

i called this api and it returns this so the platform account

summer verge Jan 3, 2022, 11:04 PM

#

You may want to remove your secret test key from that message. 🙂

sand vine Jan 3, 2022, 11:04 PM

#

you may also see its the same as in stripe account api

summer verge Jan 3, 2022, 11:05 PM

#

So in your actual running code are you trying to create a Payout on your platform account or on a connected account?

sand vine Jan 3, 2022, 11:05 PM

#

thanks for the highlighting the key mistake 🙂

#

i am trying to payout in my connected account

#

@summer verge this is one of my connected account user

#

all payouts and transfers under this connected account as you can see

#

I hope you got this now ?

summer verge Jan 3, 2022, 11:10 PM

#

Yep, so you need to make both the Balance and Payout API calls on your connected account, not your platform account. See here for details: https://stripe.com/docs/connect/authentication

sand vine Jan 3, 2022, 11:10 PM

#

okay let me check

#

@summer verge i didn't get now i need to send the header of connected account id for balance apis is it?

summer verge Jan 3, 2022, 11:15 PM

#

Yep.

#

If the Payout is being created for your connected account the connected account's balance will be used for the Payout, not your platform balance.

sand vine Jan 3, 2022, 11:18 PM

#

{
"object": "balance",
"available": [
{
"amount": 0,
"currency": "usd",
"source_types": {
"card": 0
}
}
],
"instant_available": [
{
"amount": 2100,
"currency": "usd",
"source_types": {
"card": 2100
}
}
],
"livemode": false,
"pending": [
{
"amount": 8325,
"currency": "usd",
"source_types": {
"card": 8325
}
}
]
}

Oh so this is what i got when I add connected account id in header
and yes available amount is 0$ you are right

summer verge Jan 3, 2022, 11:18 PM

#

Okay, so you need to create some charges/transfers to fill up that balance before you can pay anything out.

sand vine Jan 3, 2022, 11:19 PM

#

when we create transfer (first it will be in pending state) but after 2 or 3 days it will be in available state
So only then i can create payout.

#

Great Great Sir 🙂 Thank youuuuuuuuuuuuuuuuuuu 🙂
Now i will test and hopefully it would be done now.

#

❤️

summer verge Jan 3, 2022, 11:23 PM

#

You may also be interested in our docs about Transfer availability: https://stripe.com/docs/connect/charges-transfers#transfer-availability

#tanzeel - Connect Payouts