Migrer vers Accounts v2 ou revenir à Accounts v1Version bêta publique

L’API Accounts v2 vous permet de représenter vos comptes connectés et vos clients comme des entités configurables uniques dans Stripe. Elle associe les fonctionnalités Accounts v1 et Customers v1 dans une seule API.

Migrer vers Accounts v2 depuis Accounts v1 et Customers v1

Si votre intégration existante utilise Accounts v1 ou Customers v1, vous pouvez passer à l’API Accounts v2 pour créer de nouveaux comptes. Ces objets Account peuvent représenter à la fois des comptes connectés et des clients.

Pour mettre à jour votre intégration afin d’utiliser Accounts v2 pour les nouveaux comptes et clients :

1. Depuis la page Paramètres > Aperçus des produits de votre Dashboard, activez Accounts v2 pour vous abonner.
2. Confirmez le comportement Accounts v2 suivant :
   • Vous conservez votre accès aux API Accounts v1 et Customers v1, et tous les objets Accounts v1 et Customers v1 existants seront conservés après l’activation.
   • Les interfaces Stripe telles que le Dashboard, Checkout, l’inscription intégrée et l’inscription hébergée créent par défaut des objets Accounts v2 au lieu des objets Accounts v1 ou Customers v1.
   • La documentation de l’API utilise par défaut le contenu Accounts v2. Vous pouvez toujours accéder à la documentation Accounts v1 et Customers v1.
   • Treasury et Issuing ne prennent pas en charge les objets Accounts v2. Vous pouvez toujours utiliser Treasury et Issuing avec les objets Accounts v1.
3. Mettre à jour votre intégration pour utiliser l’API Accounts v2. Vous ne pouvez pas référencer des objets Accounts v1 ou Customers v1 dans les endpoints Accounts v2. Après avoir effectué la migration, vous devez soit :
   • Créer des objets Accounts v2 pour remplacer vos objets Accounts v1 et Customers v1 existants.
   • Mettez à jour votre intégration pour appeler les endpoints de l’API v1 pour les objets Accounts v1 et Customer v1, et les endpoints de l’API v2 pour les objets Accounts v2. Vous pouvez référencer des objets Accounts v2 dans certains endpoints API v1, mais lorsque vous faites référence à un Account représentant un client, utilisez le paramètre customer_account au lieu du paramètre customer.

Migrer de Accounts v2 vers Accounts v1 et Customers v1

Vous pouvez revenir à Accounts v1 et Customers v1 en vous désabonnant de la version bêta publique de Accounts v2.

Pour mettre à jour votre intégration afin d’utiliser Accounts v1 et Customers v1 pour les nouveaux comptes et clients :

1. Sur la page Paramètres > Aperçus des produits de votre Dashboard, désactivez Accounts v2 pour vous désabonner.
2. Acceptez le comportement de désabonnement suivant :
   • Vous conservez votre accès à l’API Accounts v2, et tous les objets Accounts v2 existants sont conservés après la désactivation.
   • Les interfaces Stripe telles que le Dashboard, Checkout, l’inscription intégrée et l’inscription hébergée créent par défaut les objets Accounts v1 et Customers v1 au lieu des objets Accounts v2.
   • La documentation de l’API utilise par défaut le contenu pour Accounts v1 et Customers v1. Vous avez cependant toujours accès à la documentation Accounts v2.
3. Mettez à jour votre intégration pour utiliser Accounts v1 pour les comptes connectés et Customers v1 pour les clients.
   • Vous pouvez utiliser l’ID acct_xxxxx de vos objets Accounts v2 dans l’API Accounts v1 pour récupérer ou mettre à jour le compte. Vous pouvez également le transmettre aux endpoints de l’API v1 dans un paramètre account.
   • Vous ne pouvez pas utiliser l’ID acct_xxxxx de vos objets Accounts v2 dans l’API Customers v1 pour récupérer ou mettre à jour l’objet Customer v1. Toutefois, vous pouvez toujours le transmettre aux endpoints de l’API v1 dans un paramètre customer_account.

Considérations relatives à la version bêta

Accounts v2 vous permet d’utiliser un compte unique configurable pour chaque entreprise de votre plateforme qui perçoit directement les paiements. La version bêta ne prend pas en charge Treasury, Issuing ou les moyens de paiement en version bêta. Vous pouvez toujours utiliser Treasury, Issuing ou des moyens de paiement en version bêta avec Accounts v1.

Activez Accounts v2 pour votre plateforme Connect depuis votre Dashboard.