Kalluste

[timber quartz]

I see that the payout has reconciliation_status which is documented but is not in the typings of NodeJS sdk. Is this expected?
https://github.com/stripe/stripe-node/blob/master/types/Payouts.d.ts#L110
Maybe you need to update, it's pretty new

Do I understand correctly that the reconciliation_status might not be "completed" when the payout is created so I should wait for payout.updated event to arrive and after the status is "completed" only then I should fetch all the balance transactions?
This is related to a change we made recently where we now create the Payout before the async reconciliation is done. But we delay sending the payout.created event until after the reconciliation is done

Are refunds also present in the balance transactions of a payout if I'm using destination transfers for my custom connected accounts with reverse_transfer: true?
Should be yes, you'd check for type: 'transfer_refund' on the BT objects

[clever nexus]

so I can expect the reconciliation_status to always be 'completed' when I receive the payout.created webhook? Just to be clear

[timber quartz]

I believe so yes. The easiest way to know will be to diff the timestamp of the event (https://stripe.com/docs/api/events/object#event_object-created) to the created field of the Payout (https://stripe.com/docs/api/payouts/object#payout_object-created). There'll be some difference because of the delay I mentioned

Alternatively, there's a new payout.reconciliation_completed event you could use: https://stripe.com/docs/api/events/types#event_types-payout.reconciliation_completed

But we made the delay change to prevent any breaking changes for existing merchants