Ajoute la propriété compte client aux API v1 afin d’assurer l’interopérabilité avec Accounts v2

Nouveautés

Ajoute la propriété customer_account, qui permet aux plateformes et marketplaces Connect utilisant Accounts v2 d’identifier les paiements encaissés pour le compte de comptes connectés ou de clients. Cette propriété est disponible dans plusieurs endpoints de l’API v1, notamment Payment Intents et Invoices.

Par exemple, vous pouvez utiliser l’API Setup Intents pour enregistrer les informations de paiement d’un compte en vue de paiements ultérieurs. Dans ce cas, Account doit être configuré comme customer.

curl https://api.stripe.com/v1/setup_intents \
  -u "${API_KEY}" \
  -H "Stripe-Version: 2025-12-15.clover" \
  -d "payment_method_types[]=stripe_balance" \
  -d "payment_method_data[type]=stripe_balance" \
  -d confirm=true \
  -d customer_account=acct_1234 \
  -d usage=off_session

Impact

Les plateformes et les marketplaces utilisant Connect facturent souvent leurs comptes connectés pour les services fournis. Jusqu’à présent, cela impliquait l’utilisation conjointe de l’API Accounts v1 et de l’API Customers v1 afin de représenter un même utilisateur via deux objets distincts. Cette approche nécessitait une collecte KYC en double, une synchronisation des données et la gestion de plusieurs ID pour un seul utilisateur.

Vous pouvez désormais utiliser l’API Accounts v2 pour créer une identité unique représentant votre utilisateur sur Stripe. Le partage des informations KYC entre l’identité client et le compte connecté améliore la conversion lors de l’onboarding et évite aux utilisateurs Connect de gérer des doublons ou une logique de relation personnalisée complexe.

Transmettez l’identifiant du compte de votre utilisateur dans la propriété customer_account pour les API qui collectent ou suivent des paiements.

Aucune modification n’est nécessaire si votre intégration repose sur Customers v1 et la propriété customer. Si vous envisagez d’utiliser l’API Accounts v2 pour des comptes connectés nouveaux ou existants, inscrivez-vous depuis le Dashboard.

Modifications

Mise à niveau