List of Charges by Payout / Balancer Transfer

[Dave Rapin]

I'm using Connect w/ custom accounts, and a recurring request from my clients is to see the list of charges that contributed to a payout in order for them to reconcile their books. I figured it would be straightforward, since the Stripe UI shows a summary of charges when you dig into the details of a payout... but I haven't been able to figure it out.

I was expecting a Charge.list call passing a Payout (more convenient) or Balance Transfer ID (less convenient).

I can't imagine I am the only person to need this though, so I figured I'd ask here.

What would be to recommended way to do this?

[Remi J.]

Hey Dave,

What you are looking for is the Balance History API [1]. If you provide the payout identifier (po_XXX) in the `payout` parameter you will get a list of transactions that were transferred out on the specified payout [2]. This will give you a list of Balance Transaction objects [3] representing the transactions that were bundled in the Payout.

Each one will have a `source` property [4] set to the id of the object making that balance transaction such as the charge id (ch_XXX) or the refund id (re_XXX). You can also use the Expand feature [5] which lets you expand the id of an object into the full object. That way, you get the balance transactions and the corresponding charge, refund or even retried Payout object to display what you want to your customer.

Hope this helps!

Remi

[1] https://stripe.com/docs/api#balance_history

[2] https://stripe.com/docs/reporting#reconciling-individual-payouts

[3] https://stripe.com/docs/api#balance_transaction_object

[4] https://stripe.com/docs/api#balance_transaction_object-source

[5] https://stripe.com/docs/api#expanding_objects

--
You received this message because you are subscribed to the Google Groups "Stripe API Discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to api-discuss+unsubscribe@lists.stripe.com.
To post to this group, send email to api-d...@lists.stripe.com.
Visit this group at https://groups.google.com/a/lists.stripe.com/group/api-discuss/.

[Dave Rapin]

That's exactly what I need, thank you very much!

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