#ANNA SUN - Payout Status
stuck geode
misty dirge
Also a follow up question: If I do a standard payout, shouldn't it take 1-2 business days (assume we're in the US) for it to appear? In test mode, it seems like from the start of the payout to when the status changes to paid, its done within a second?
image^
stuck geode
There is a big discrepancy between payout speed between LIve and test mode.
In test mode we don't actually communicate with Banks so we aren't stuck with their timeline 😅
misty dirge
I see I thought Stripe would have its own mock intervals to simulate the speed
misty dirge
Because it looks like it transitions between statuses quickly, but in a real live mode, it'd actually take longer
So when does the payout.paid webhook get fired? When the funds appear in the account or when Stripe successfully releases the funds, then its up to the bank to process it?
stuck geode
Here's the text from our docs:
payout.paid
Occurs whenever a payout is expected to be available in the destination account. If the payout fails, a payout.failed notification is also sent, at a later time.
and the doc: https://stripe.com/docs/api/events/types#event_types-payout.paid
So if you are using webhooks for some sort of notification you'll want to be able to handle a payout.paid => payout.failed process as well
This has to do with the time it takes banks to respond and process declines.
misty dirge
The moment the payout is created through the API, can you cancel that payout at all? Is there some way you can delay the payout by like 1 hr?
stuck geode
Are these scheduled payouts or manual payouts?
stuck geode
Yeah I'm not seeing anything on being able to add a delay so you can cancel: https://stripe.com/docs/connect/manual-payouts
You can reverse the payout though: https://stripe.com/docs/connect/payout-reversals
misty dirge
Ah okay
This is useful for stuff like handling fraud or something? Like if a user gets hacked and the hacker swaps it to another bank/debit account
Then someone can reverse the payout?
misty dirge
👍 Thanks!
stuck geode
If you get around to using Scheduled payouts you can use features like delay_days to give your platform the chance to do any fraud checks: https://stripe.com/docs/connect/manage-payout-schedule
vestal mauveBOT
This thread has been archived. If you need help with anything else please ask in #dev-help or contact Stripe Support: https://support.stripe.com/contact
last shadow
@misty dirge I've re-opened this for your question
misty dirge
When does the payout's status go to in_transit? Is there a way to test this thru Stripe?
Ty. yeah I'm just trying to see if I can simulate different statuses for Payout?
last shadow
From the docs: https://stripe.com/docs/api/payouts/object#payout_object-status
A payout is pending until it is submitted to the bank, when it becomes in_transit. The status then changes to paid if the transaction goes through, or to failed or canceled (within 5 business days).
So this would happen when Stripe submits it to the bank
You can test the different paid/failed flows using the test accounts here: https://stripe.com/docs/connect/testing#account-numbers
I'm not sure if the test payouts spend any appreciable time in the in_transit status, though
last shadow
The created event, yes, more or less
It's not synchronous/instantaneous, but should be delivered soon afterward
misty dirge
Ah I see
if I wanna save the Payout details to the DB, maybe its better to do it using Webhook?
Instead of doing it in my service layer
Where I am invoking the Stripe API to call the payout api
last shadow
That's up to you, you'd get the payout object in either case, as the request response or the webhook payload data