Connected Accounts

If you use Stripe Connect, you can issue requests on behalf of your connected accounts. To act as a connected account, include a Stripe-Account header containing the connected account ID, which typically starts with the acct_ prefix.

The connected account ID is set per-request. Methods on the returned object reuse the same account ID.

• Related guide: Making API calls for connected accounts

curl https://api.stripe.com/v1/charges/ch_3LmjFA2eZvKYlo2C09TLIsrw \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -H "Stripe-Account: acct_1032D82eZvKYlo2C" \
  -G

require 'stripe'
# Test mode key; don't put live keys in code. See https://docs.stripe.com/keys-best-practices.
client = Stripe::StripeClient.new("sk_test_BQokikJOvBiI2HlWgH4olfQ2")

charge = client.v1.charges.retrieve(
  'ch_3Lmjo22eZvKYlo2C1kuO4yZM',
  {},
  {
    stripe_account: 'acct_1032D82eZvKYlo2C',
  }
)
charge.capture # Uses the same account.

stripe charges retrieve ch_3LmjIH2eZvKYlo2C067UssSm \
    --stripe-account acct_1032D82eZvKYlo2C

from stripe import StripeClient
# Test mode key; don't put live keys in code. See https://docs.stripe.com/keys-best-practices.
client = StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2")

charge = client.v1.charges.retrieve(
  "ch_3Lmjoz2eZvKYlo2C1rBER4Dk",
  options={
    "stripe_account": "acct_1032D82eZvKYlo2C"
  }
)
charge.capture() # Uses the same account.

$ch = $stripe->charges->retrieve(
  'ch_3Lmjrl2eZvKYlo2C1bscjw8Z',
  [],
  ['stripe_account' => 'acct_1032D82eZvKYlo2C']
);
$ch->capture(); // Uses the same account.

// Test mode key; don't put live keys in code. See https://docs.stripe.com/keys-best-practices.
StripeClient stripeClient = new StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");
RequestOptions requestOptions = RequestOptions.builder()
  .setStripeAccount("acct_1032D82eZvKYlo2C")
  .build();

Charge charge = stripeClient.v1().charges().retrieve("ch_3LmjsM2eZvKYlo2C1CcKvJbn", requestOptions);

stripe.charges.retrieve('ch_3LmjSR2eZvKYlo2C1cPZxlbL', {
  stripeAccount: 'acct_1032D82eZvKYlo2C'
});

// Test mode key; don't put live keys in code. See https://docs.stripe.com/keys-best-practices.
sc := stripe.NewClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2")
params := &stripe.ChargeRetrieveParams{}
params.SetStripeAccount("acct_1032D82eZvKYlo2C")
ch, err := sc.V1Charges.Retrieve(context.TODO(), "ch_3Lmjso2eZvKYlo2C0rTTv0MK", params)

// Test mode key; don't put live keys in code. See https://docs.stripe.com/keys-best-practices.
var client = new StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");
var options = new RequestOptions
{
  StripeAccount = "acct_1032D82eZvKYlo2C"
};
Charge charge = client.V1.Charges.Get(
  "ch_3Ln3kB2eZvKYlo2C1YRBr0Ll",
  null,
  options
);