Stripe-Context ヘッダー

デフォルトでは、API リクエストは、付随する API キーを生成した Stripe アカウントで実行されます。ただし、Stripe-Context ヘッダーを使用して、関連するアカウントのコンテキストで API リクエストを実行することは可能です。

API リクエストの範囲

次のように、さまざまなスコープ内で実行される API リクエストを作成できます。

• 自分のアカウント
• プラットフォームの任意の連結アカウント
• 加盟店または受取人の設定を含む任意の v2 アカウント

API キーの所有アカウント以外のアカウントに API リクエストを行う場合は、Stripe-Context ヘッダーを含めて対象のアカウントを指定する必要があります。この値は、リクエストに使用した API キーと対象アカウントの相対関係によって異なります。

さまざまな事業を代表するプラットフォームアカウントを複数持つ組織を例に考えてみましょう。各プラットフォームには連結アカウントがあり、さらに各連結アカウントには受取人アカウントがあります。

このビジネス構造では、さまざまなスコープを使用して API リクエストを実行できます。次の表は、リクエストした API キーを所有するアカウントとの関係に基づいてコンテキストが必要になるスコープの Stripe-Context 形式を示しています。

ユースケースの例

次のコードサンプルは、連結アカウントの受取人が利用できる銀行口座を Rocket US プラットフォームが取得するためのリクエストです。受取人はプラットフォームの_孫_に当たるため、コンテキストでは <connected account ID>/<recipient ID> という形式が使用されます。

curl https://api.stripe.com/v2/core/vault/us_bank_accounts \
  -H "Authorization: Bearer {{PLAT_SECRET_KEY}}" \
  -H "Stripe-Version: 2025-03-31.preview" \
  -H "Stripe-Context: acct_111a/acct_111b"