Possible to query a Stripe managed account's balance?

Question

I've gone through the docs and haven't been able to spot a way to query balance info for Stripe managed accounts. Here's the use case: a 3rd party sets up a managed account through my Stripe Connect enabled platform; I create some charge objects on their account after a few customers buy goods/services (so their balance is now positive); now they want a payout BUT I want to query their balance before issuing the transfer to ensure they're not asking for more than is in their account.

Surely I'm missing something obvious. Thanks in advance.

The response returns an object like this: `{ "object": "balance", "available": [ { "currency": "usd", "amount": 0, "source_types": { "card": 0 } } ], "connect_reserved": [ { "currency": "usd", "amount": 0 } ], "livemode": false, "pending": [ { "currency": "usd", "amount": 0, "source_types": { "card": 0 } } ] }` Why is the `available` and `pending` props an ARRAY? It makes no sense to me! — Walter Monecke, Dec 28 '17 at 17:48

score 14 · Answer 1 · answered Apr 11 '16 at 22:52

14

So for Ruby, based on Ywain's answer, I figured that instead of doing what's documented:

Stripe.api_key = CONNECTED_STRIPE_ACCOUNT_SK
Stripe::Balance.retrieve

a better way, that is not documented, is to do:

Stripe::Balance.retrieve(stripe_account: CONNECTED_STRIPE_ACCOUNT_ID)

as long as the current api_key is your platform account with the managed accounts option enabled.

answered Apr 11 '16 at 22:52

pierrea

1,368
14
18

7

Exactly what I was looking for. How is this not documented – Stephen Corwin Jun 16 '16 at 21:06
thanks pierrea! agreed, this needs to be added in the stripe docs – gitastic Jul 25 '16 at 01:25

score 7 · Answer 2 · answered Mar 08 '17 at 01:57

PHP

\Stripe\Balance::retrieve([
    'stripe_account' => CONNECTED_STRIPE_ACCOUNT_ID
]);

Python

stripe.Balance.retrieve(
  stripe_account=CONNECTED_STRIPE_ACCOUNT_ID
)

Ruby

Stripe::Balance.retrieve(
  :stripe_account => CONNECTED_STRIPE_ACCOUNT_ID
)

Node

stripe.balance.retrieve({
  stripe_account: CONNECTED_STRIPE_ACCOUNT_ID
}, function(err, charge) {});

score 4 · Accepted Answer · answered Sep 18 '15 at 21:38

4

You should be able to do this by simply issuing a balance retrieval call while authenticating as the connected account, e.g.:

curl https://api.stripe.com/v1/balance \ -H "Authorization: Bearer {PLATFORM_SECRET_KEY}" \ -H "Stripe-Account: {CONNECTED_STRIPE_ACCOUNT_ID}"

answered Sep 18 '15 at 21:38

Ywain

16,854
4
51
67

Yup, knew it was something easy. Thanks. – maxhs Sep 19 '15 at 15:26

Possible to query a Stripe managed account's balance?

3 Answers3