# En-tête Stripe-Context

Effectuer des opérations d’API sur des comptes associés.

Par défaut, les requêtes API sont exécutées sur le compte Stripe qui a généré la [clé API](https://docs.stripe.com/keys.md) associée. Cependant, vous pouvez utiliser l’en-tête `Stripe-Context` pour effectuer une requête API dans le contexte d’un compte associé.

> L’en-tête `Stripe-Context` remplace l’en-tête `Stripe-Account`, ce qui facilite [l’exécution d’opérations d’API sur les comptes connectés](https://docs.stripe.com/connect/authentication.md). `Stripe-Context` élargit le champ d’application et les types de comptes associés auxquels ils peuvent accéder.

## Champ d’application de la requête API

Vous pouvez effectuer des requêtes API pour opérer dans différents champs d’application :

- Votre propre compte
- Tous les comptes connectés de votre plateforme
- Tout compte v2 avec au moins la configuration de marchand ou de bénéficiaire
- Tous les comptes de votre organisation

Lorsque vous effectuez une requête API ciblant un compte autre que celui de la clé API, vous devez identifier le compte visé en incluant l’en-tête `Stripe-Context`. La valeur dépend de la relation relative entre le compte visé et la [clé API](https://docs.stripe.com/keys.md) utilisée pour effectuer la requête.

Prenons l’exemple d’une organisation possédant plusieurs comptes de plateforme représentant différents secteurs d’activité. Chaque plateforme a des comptes connectés et un compte connecté a un compte de bénéficiaire.

Organisation avec plusieurs comptes de plateforme autonomes représentant différents secteurs d’activité, chacun avec des comptes connectés. (See full diagram at https://docs.stripe.com/context)

```text
[Rocket, Inc.Organisation org_1234] --> [Rocket RidesCompte de plateforme acct_111]
[Rocket, Inc.Organisation org_1234] --> [Rocket RepairsCompte de plateforme acct_222]
[Rocket, Inc.Organisation org_1234] --> [Rocket DeliveriesCompte de plateforme acct_333]
[Rocket RidesCompte de plateforme acct_111] --> [Conducteur SmithCompte connecté acct_111a]
[Rocket RepairsCompte de plateforme acct_222] --> [Mécanicien JonesCompte connecté acct_222a]
[Rocket DeliveriesCompte de plateforme acct_333] --> [Coursier VegaCompte connecté acct_333a]
[Conducteur SmithCompte connecté acct_111a] --> [Ville d’achat du carburantCompte du bénéficiaire acct_111b]
```

Compte tenu de cette structure d’entreprise, il est possible d’effectuer des requêtes API à l’aide de plusieurs champs d’application différents. Le tableau suivant indique le format `Stripe-Context` pour chaque champ d’application nécessitant un contexte en fonction de sa relation avec le compte auquel appartient la clé API requérante.

| Propriétaire de la clé API requérante | Champ d’application du compte | Format Stripe-Context |
| --- | --- | --- |
| Rocket, Inc. | Rocket Rides | ID de plateforme : `acct_111` |
| Rocket, Inc. | Conducteur Smith | ID de plateforme/ID de compte connecté : `acct_111/acct_111a` |
| Rocket Rides | Conducteur Smith | ID du compte connecté : `acct_111a` |
| Rocket Deliveries | Coursier Vega | ID du compte connecté : `acct_333a` |
| Rocket Rides | Ville d’achat du carburant | ID du compte connecté/ID du bénéficiaire : `acct_111a/acct_111b` |