Comparer les configurations des plateformes SaaS pour Accounts v1 et Accounts v2Version bêta publique

Découvrez comment une plateforme SaaS facture ses comptes connectés avec Stripe Billing en utilisant Accounts v2.

Les plateformes SaaS (Software as a Service) qui utilisent Connect facturent souvent des frais d’abonnement pour fournir leurs services de plateforme. Accounts v1 exige des plateformes qu’elles conservent des objets Stripe distincts pour permettre à une même entreprise de payer un abonnement (en tant que Customer) et d’opérer sur la plateforme (en tant qu’Account). Accounts v2 vous permet de gérer l’ensemble des interactions avec vos comptes connectés au travers d’un seul objet à plusieurs configurations.

L’API Accounts v2

Dans l’API v2, les objets Account peuvent avoir plusieurs configurations. Chaque configuration représente un type différent de relation d’entreprise et permet d’activer différents produits Stripe. En attribuant plusieurs configurations à un Account, une plateforme SaaS peut activer à la fois Connect et Billing pour celui-ci sans avoir à créer également un objet Customer.

L’API Accounts v2 fournit :

Représentation unifiée : un seul objet Account peut représenter plusieurs relations entre les comptes connectés et votre plateforme.
Configurations flexibles : activez ou modifiez les produits et fonctionnalités Stripe en modifiant les configurations attribuées à un Account.
Données d’identité centralisées : l’objet Account stocke toutes les données d’identité d’un compte connecté. Lorsque vous ajoutez une configuration à un Account existant, vous n’avez pas besoin de collecter les exigences qu’il a déjà fournies.

En consultant la documentation Stripe, gardez à l’esprit les différences structurelles entre un objet Account dans l’API v2 et un objet Account dans l’API v1. Par exemple :

Dans Accounts v2, certaines propriétés font partie des propriétés configuration ou identity d’un objet Account.
Dans l’API v2, les objets Accountsassocient des fonctionnalités comme card_payments et stripe_balance.stripe_transfers à un type de configuration.
Dans l’API v2, chaque exigence possède ses propres propriétés status. Dans l’API v1, un objet Account comprend des tableaux pour chaque état d’exigence, et les exigences apparaissent dans un ou plusieurs de ces tableaux, en fonction de leur état.

Le tableau suivant illustre la mise en correspondance de certaines propriétés Accounts v1 avec les propriétés Accounts v2.

Propriété Accounts v1	Propriété Accounts v2
business_profile.url	defaults.profile.business_url
business_profile.support_url	configuration.merchant.support.url
business_profile.product_description	defaults.profile.product_description
Chaque exigence apparaît dans un ou plusieurs tableaux, en fonction de son état. requirements.currently_due requirements.eventually_due requirements.past_due	Toutes les exigences sont regroupées dans un seul tableau. Pour vérifier l’état d’une exigence, consultez son `minimum_deadline.status`. État des exigences individuelles : requirements.entries.minimum_deadline.status Prochain état : requirements.summary.minimum_deadline.status

Utilisation de Connect et Billing dans l’API v1 avec les objets Account et Customer

Dans l’API v1, les objets Account ne prennent en charge que les fonctions Connect. Pour facturer un compte connecté à l’aide d’un abonnement, une plateforme doit créer un objet Customer représentant le même compte connecté. Accounts v1 et Customers v1 n’ont pas de lien explicite ; la plateforme doit donc gérer ces objets séparément et maintenir une correspondance entre les identifiants Account et les identifiants Customer.

Relations de la plateforme SaaS avec les objets Account et Customer dans l’API v1

Utilisation de Connect et Billing dans l’API v2 avec les objets Account

Avec Accounts v2, un compte connecté qui perçoit des paiements et vous verse des frais d’abonnement n’a pas besoin d’un objet Account et d’un objet Customer. Il suffit de le représenter en attribuant les configurations applicables à Account.

Pour permettre à un compte connecté de percevoir les paiements des clients, attribuez la configuration de marchand à l’objet Account correspondant.

Plateforme et objet Account avec une configuration de marchand

Pour permettre à la plateforme de collecter des paiements, y compris des paiements d’abonnement, à partir du compte connecté, ajoutez la configuration de client à l’objet Account.

Plateforme et objet Account avec des configurations de marchand et de client

Remarque

Vous pouvez percevoir des commissions de plateforme à partir d’un Account ayant la configuration de marchand. L’attribution de la configuration de client n’affecte pas cette capacité.

Considérations relatives à la version bêta

Accounts v2 vous permet d’utiliser un compte unique et configurable pour chaque entreprise de votre plateforme qui encaisse directement les paiements. La version bêta ne prend pas en charge Financial Accounts pour les plateformes, Issuing ou les moyens de paiement qui sont en aperçu. Vous pouvez toujours utiliser Financial Accounts pour les plateformes, Issuing ou moyens de paiement en version bêta avec Accounts v1.

Activez Accounts v2 pour votre plateforme Connect depuis votre Dashboard.