Paiements de plateforme SaaS avec facturation d'abonnements à l'aide d'Accounts v2Version bêta privée

SaaS (Software as a Service) platforms using Connect often charge subscription fees for providing their platform services. Accounts v1 requires platforms to maintain separate Stripe objects to enable a single business to both pay for a subscription (as a Customer) and operate on the platform (as an Account). Accounts v2 allows you to manage all your interactions with your connected accounts through a single, multi-configuration object.

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

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 se caractérise par les éléments suivants :

• 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 changeant les configurations attribuées à un objet 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.

Considérations relatives à la version bêta privée

La version bêta privée de Accounts v2 présente certaines limites. Voici quelques exemples :

• Produits Stripe : l’intégration en version bêta utilise Billing pour collecter les frais perçus au titre de l’abonnement et Connect pour permettre les paiements intégrés.
• Accès au Dashboard et types de comptes : vos comptes connectés ne peuvent pas utiliser le Dashboard complet ou le Dashboard Stripe Express. Créez une interface personnalisée ou utilisez les composants intégrés de Connect.
• Moyens de paiement : les objets Accounts ayant la configuration de marchand peuvent uniquement accepter les paiements par carte bancaire. Ils ne peuvent pas accepter les paiements par portefeuille ni les paiements Link, même avec l’intégration de Link.
• Types de paiement : l’intégration de la version bêta ne prend en charge que les paiements directs et les paiements indirects avec le paramètre on_behalf_of. Vous ne pouvez pas utiliser les paiements indirects sans on_behalf_of ni les paiements et transferts distincts.