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.

Ajouter 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"

Ajouter 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}},
});

Utilisez les composants intégrés de Connect

Au lieu d’intégrer directement les API de Stripe, vous pouvez utiliser des composants intégrés Connect pour fournir les fonctionnalités Stripe à vos comptes connectés dans l’interface utilisateur de votre plateforme. Ces composants nécessitent moins de code pour implémenter et gérer tous les appels à l’API en interne.

Par exemple, pour afficher les données de paiement à vos comptes connectés, intégrez le composant Payments dans l’interface utilisateur de votre plateforme. Cela élimine la nécessité d’effectuer des appels distincts à l’API Charges, Payment Intents, Refunds et Disputes.

Pour obtenir la liste complète des composants intégrés disponibles, consultez la page Composants pris en charge.