Making API calls for connected accounts (original) (raw)

Learn how to add the right information to your API calls so you can make calls for your connected accounts.

Copy page

You can make API calls for your connected accounts:

• Server-side with the Stripe-Account header and the connected account ID, per request
• Client-side by passing the connected account ID as an argument to the client library

To help with performance and reliability, Stripe has established rate limits and allocations for API endpoints.

To make server-side API calls for connected accounts, use the Stripe-Account header with the account identifier, which begins with the prefix acct_. Here are four examples using your platform’s API secret key and the connected account’s Account identifier:

`curl https://api.stripe.com/v1/payment_intents
-u "

sk_test_BQokikJOvBiI2HlWgH4olfQ2

:"
-H "Stripe-Account:

{{CONNECTED_ACCOUNT_ID}}

"
-d amount=1000
-d currency=usd`

The Stripe-Account header approach is implied in any API request that includes the Stripe account ID in the URL. Here’s an example that shows how to Retrieve an account with your user’s Account identifier in the URL.

`curl https://api.stripe.com/v1/accounts/

{{CONNECTED_ACCOUNT_ID}}

-u "

sk_test_BQokikJOvBiI2HlWgH4olfQ2

:"`

All of Stripe’s server-side libraries support this approach on a per-request basis:

`curl https://api.stripe.com/v1/customers
-u "

sk_test_BQokikJOvBiI2HlWgH4olfQ2

:"
-H "Stripe-Account:

{{CONNECTED_ACCOUNT_ID}}

"
--data-urlencode email="person@example.com"`

Adding the connected account ID to a client-side application

Client-side libraries set the connected account ID as an argument to the client application:

The JavaScript code for passing the connected account ID client-side is the same for plain JS and for ESNext.

`var stripe = Stripe(

'pk_test_TYooMQauvdEDq54NiTphI7jx'

, { stripeAccount:

{{CONNECTED_ACCOUNT_ID}}

, });`