Appels à l'API pour les comptes connectés

Vous pouvez lancer des appels à l’API pour les comptes connectés :

• Côté serveur avec l’en-tête Stripe-Account et l’ID du compte connecté, par requête
• Côté client, en transmettant l’ID du compte connecté comme argument à la bibliothèque client

Pour optimiser les performances et la fiabilité, Stripe a établi des limites de débit et des affectations pour les endpoints d’API.

Ajout de l’en-tête Stripe-Account côté serveur

Pour effectuer des appels à l’API côté serveur pour les comptes connectés, utilisez l’en-tête Stripe-Account avec l’identifiant du compte, qui commence par le préfixe acct_. Voici quatre exemples utilisant la clé secrète API de votre plateforme et l’identifiant de compte de votre compte connecté :

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd

L’approche d’en-tête Stripe-Account est implicite dans toute requête API qui inclut l’ID du compte Stripe dans l’URL. Voici un exemple qui montre comment récupérer un compte avec l’identifiant du compte de votre utilisateur dans l’URL.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Toutes les bibliothèques de Stripe côté serveur prennent en charge l’approche suivante pour chaque requête :

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  --data-urlencode email="person@example.com"

Ajout de l’ID du compte connecté à une application côté client

Les bibliothèques côté client configurent l’ID du compte connecté comme argument de l’application client :

var stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: 
{{CONNECTED_ACCOUNT_ID}},
});