#bryan_webhooks
calm patrolBOT
👋 Welcome to your new thread!
⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.
⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.
🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1240479501687722096
📝 Have more to share? Add more details, code, screenshots, videos, etc. below.
vital lintel
Hi there, the balance.available event contains a balance object, which doesn't have direct relationships with payouts or payments.
edgy reef
Any recommendations on how to track/map a payouts availability?
vital lintel
So you want to get notified when a payout is created?
edgy reef
No, when a payout is available in a connected account balance
vital lintel
You mean when funds are ready for payout on a conected account balance?
edgy reef
You mean when funds are ready for payout on a conected account balance?
Correct
vital lintel
Ok, I think you are talking payout reconciliation? https://docs.stripe.com/reports/payout-reconciliation
edgy reef
I am using manual payouts
vital lintel
If you use manual payouts or prefer to track and reconcile your Stripe balance like a bank account, see the Balance report instead.
edgy reef
Is there a better event to listen to other than balance.available that maps back to something like a customer or product?
vital lintel
It really depends on what you need. If you want to get notified when a customer complete checkout, listen to checkout.sesssion.completed events
https://docs.stripe.com/api/events/types this page gives you all types of events that you can listen to
edgy reef
I’m basically collecting and paying out using this approach https://docs.stripe.com/connect/collect-then-transfer-guide customer pays $100 and I payout $50 to the connected account I want to get notified when the $50 is available in the stripe balance so I can initiate a payout
vital lintel
If you are using destination charge (i.e., set transfer_data[destination]), Stripe will automatically transfer the funds to your connected account when the associated funds are ready for payout. You don't need to explcitly initiate the transfer.
So for the connected accounts, if they are on auto-payout, the funds that previously transferred from your platform will automatically move into their external bank accounts according to their payout schedule.
You don't need to listen to any events to achieve all these.
edgy reef
Perfect, thanks!
How about if I require approval on my end before the payout moves to the bank account?
vital lintel
You can implement your own approval process and use manual payouts instead.
edgy reef
That’s what we are doing, are you saying if we use a destination charge we can map that back to something?
vital lintel
Let me clarify what you want to achieve, you want the platform to collect accept the payment, but you don't want Stripe to automatically transfer the funds to the connected account, and you want to manually transfer the funds to the connected account based on your logic, is my understanding correct?
edgy reef
I want stripe to transfer the funds to the connected accounts balance but only want to initiate the payout to the connected accounts bank account when approval happens on my end and It’s available to be payed out
vital lintel
OK, then you should still use destination charges, and set the connected account's payout schedule interval to manual https://docs.stripe.com/api/accounts/update#update_account-settings-payouts-schedule-interval
edgy reef
Is there an event related to when a destination charge is available in a stripe balance?
vital lintel
For destination charges, if you want to know when the money transferred to the connected account becomes available for payout, i would suggest you listen for the payment_intent.succeeded event. Upon receipt of that event, make a request to retrieve the Charge [0][1] and expand [2] the response to include transfer.destination_payment.balance_transaction. The corresponding Balance Transaction in the response will contain available_on which shows when the funds will be available to be paid out :