Créer des abonnements avec Stripe Billing

Si vous développez une plateforme, vous pouvez créer des abonnements pour les clients de vos comptes connectés. Vous pouvez éventuellement prélever une commission de plateforme à chaque paiement.

Dans cet exemple, une plateforme de publication en ligne permet aux clients de s’abonner à leurs auteurs préférés et de leur verser un abonnement mensuel afin de recevoir des articles de blog premium.

Avant de commencer

Avant de pouvoir créer des abonnements pour vos clients ou vos comptes connectés, vous devez :

1. Créer un compte connecté pour chaque personne qui reçoit de l’argent sur votre plateforme. Dans notre exemple de publication en ligne, un compte connecté représente un auteur.
2. Créer un modèle tarifaire. Pour cet exemple, nous créons un modèle tarifaire à taux fixe pour débiter des frais aux clients de manière récurrente, mais les tarifs par utilisateur et à l’usage sont également pris en charge.
3. Créez un objet Customer avec le moyen de paiement souhaité pour chaque personne qui s’abonne à un compte connecté. Dans notre exemple de publication en ligne, vous créez un objet Customer pour chaque lecteur qui s’abonne à un auteur.

Choisir entre les paiements directs et indirects

Vous pouvez utiliser des paiements directs ou indirects pour fractionner le paiement d’un client entre le compte connecté et votre plateforme.

Si les paiements sont directs, les clients ne sont pas conscients de l’existence de votre plateforme car c’est le nom de l’auteur, et non celui de votre plateforme, qui apparaît sur le libellé de relevé bancaire. Dans notre exemple de publication en ligne, les lecteurs interagissent directement avec les auteurs.

Les paiements directs sont recommandés pour les comptes connectés ayant accès à l’intégralité du Dashboard Stripe, ce qui inclut les comptes Standard.

Si vous souhaitez que votre plateforme soit responsable des frais Stripe, remboursements et contestations de paiement, utilisez les paiements directs. Dans notre exemple de publication en ligne, les clients s’inscrivent à votre plateforme de publication, et non directement à des auteurs spécifiques.

Les paiements indirects sont recommandés pour les comptes connectés avec accès au Dashboard Express ou les comptes connectés sans accès à un tableau de bord hébergé par Stripe, ce qui inclut les comptes Express et Custom.

Pour en savoir plus sur les différents types de paiements Connect, veuillez consulter la section concernant les types de paiements.

Utiliser les paiements directs pour créer un abonnement

Pour créer un abonnement avec des paiements associés au compte connecté, créez un abonnement en tant que compte connecté. Assurez-vous de définir le client avec un moyen de paiement par défaut, et le tarif du compte connecté. Pour utiliser un client sans moyen de paiement par défaut, définissez payment_behavior: "default_incomplete". En savoir plus sur le comportement de paiement.

Développez latest_invoice.payment_intent pour inclure l’Element Payment, qui est nécessaire pour confirmer le paiement. Pour en savoir plus, veuillez consulter Element Payment.

Pour voir un exemple illustrant l’implémentation d’un flux d’inscription pour les abonnements et d’un tunnel de paiement dans votre application, veuillez consulter le guide sur l’intégration des abonnements.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.payment_intent"

Utiliser les paiements indirects pour créer un abonnement

Pour créer un abonnement avec des paiements associés à la plateforme, ainsi que des transferts automatiques vers un compte connecté, effectuez un appel de création d’abonnement en fournissant l’identifiant du compte connecté comme valeur pour le paramètre transfer_data[destination].

Développez latest_invoice.payment_intent pour inclure l’Element Payment, dont vous avez besoin pour confirmer le paiement. Pour en savoir plus, veuillez consulter la section concernant Element Payment.

Vous avez la possibilité de spécifier un paramètre application_fee_percent. Pour en savoir plus, veuillez consulter la section concernant la perception de frais.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.payment_intent" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Mesures supplémentaires à prendre avant de créer un abonnement

Pour créer un paiement indirect, il vous faut définir à la fois le client et le tarif sur le compte de la plateforme. Vous devez avoir créé un compte connecté sur la plateforme. Le client doit exister au sein du compte de la plateforme. Les paiements indirects sont réalisés au nom de la plateforme.

Vous pouvez utiliser Stripe Billing pour créer des abonnements afin que vos clients finaux puissent effectuer des transactions directement avec votre plateforme sans impliquer vos comptes connectés.

Dans cet exemple, une place de marché est créée pour permettre aux clients de se faire livrer à la demande par des restaurants. Cette place de marché propose aux clients un abonnement mensuel premium qui les dispense des frais de livraison. Les clients qui s’abonnent à l’offre premium paient directement la place de marché et ne s’abonnent pas à un service de livraison ou à un restaurant particulier.

Avant de commencer

Avant de créer des abonnements pour vos clients, vous devez :

1. Créer un modèle tarifaire. Pour cet exemple, nous créons un modèle tarifaire à taux fixe pour débiter des frais aux clients de manière récurrente, mais les tarifs par utilisateur et à l’usage sont également pris en charge.
2. Créer un client pour chaque personne que vous souhaitez facturer.

Vous pouvez également créer un compte connecté pour chaque utilisateur qui reçoit de l’argent provenant de votre place de marché. Dans notre exemple de livraison de repas à la demande, un compte connecté représente un restaurant ou un service de livraison. Cependant, cette étape n’est pas nécessaire pour l’inscription de nouveaux clients à votre place de marché.

Créer un abonnement

Pour créer un abonnement et définir votre plateforme comme destinataire des fonds (sans qu’ils transitent par les comptes connectés), suivez les instructions du guide des abonnements pour créer un abonnement avec Stripe Billing.

Créer des paiements et transferts distincts

Si vous souhaitez transférer manuellement une partie des fonds reçus par votre plateforme vers vos comptes connectés, utilisez Paiements et transferts distincts. Dans notre exemple de service de livraison de restauration à la demande, vous pouvez utiliser des frais et des transferts distincts pour verser une commission d’affiliation à un livreur ou à un restaurant ayant recommandé à un client de s’abonner au service de livraison premium.

Vous pouvez utiliser Stripe Billing pour créer des abonnements afin de prélever une commission sur vos comptes connectés pour l’utilisation de votre plateforme.

Cet exemple présente une plateforme logicielle de gestion de salles de sport. En contrepartie d’une commission mensuelle, ces entreprises peuvent utiliser le logiciel pour gérer la planification et les horaires de cours. Les frais d’inscription incombent aux salles de sport, et non à leurs clients.

Le logiciel de gestion de salles de sport simplifie les paiements ponctuels entre les usagers et les entreprises pour chaque cours auquel un usager s’inscrit. Cet abonnement mensuel lie le compte connecté et la plateforme, l’usager de la salle de sport n’est donc pas impliqué dans cette transaction.

Dans le diagramme ci-dessus, la salle de sport représente le compte connecté et l’usager est le client final.

Avant de commencer

Avant de créer des abonnements pour vos clients ou vos comptes connectés, vous devez :

1. Créer un compte connecté pour chaque utilisateur qui reçoit de l’argent sur votre plateforme. Dans cet exemple, le compte connecté représente la salle de sport.
2. Créer un modèle tarifaire. Pour cet exemple, nous créons un modèle tarifaire à taux fixe pour débiter des frais aux clients de manière récurrente, mais les tarifs par utilisateur et à l’usage sont également pris en charge.
3. Créer un client sur la plateforme avec le moyen de paiement prévu pour chaque compte connecté que vous souhaitez facturer. Dans l’exemple du logiciel de gestion de salles de sport, vous devez créer un client pour chaque salle de sport :

Créer un objet Customer pour représenter le compte connecté

Si vos comptes connectés utilisent Stripe pour traiter les paiements de leurs clients, ils ont peut-être déjà créé un objet Customer pour chaque client final.

Pour créer un abonnement permettant au compte connecté de payer des frais récurrents sur la plateforme, vous devez d’abord créer un objet Customer distinct représentant ce compte connecté.

Dans l’exemple de la salle de sport, cette entreprise utilise Stripe pour traiter les paiements ponctuels de ses clients. Ils ont déjà créé un objet Customer pour chaque usager de la salle, mais vous devez en créer un autre pour représenter la salle de sport elle-même. Ne créez qu’un seul Customer pour représenter chaque société. À l’inverse, ne créez pas de Customer pour chaque propriétaire, gestionnaire ou opérateur de la société.

Créer un abonnement pour le compte connecté

Pour créer un abonnement à l’endroit où votre plateforme reçoit les fonds de vos comptes connectés, suivez les instructions du guide des abonnements pour créer un abonnement avec Stripe Billing. L’objet Customer impliqué dans la transaction représente le compte connecté (et non le client final). Dans notre exemple de salle de sport, le CUSTOMER_ID représente l’entreprise, pas l’usager.

Stripe creates event notifications when changes happen in your account, like when a recurring payment succeeds or when a payout fails. To receive these notifications and use them to automate your integration, set up a webhook endpoint. For example, you could provision access to your service when you receive the invoice.paid event.

Event notifications for Connect and subscriptions integrations

Here are the event notifications that Connect integrations typically use.

Here are the event notifications that subscriptions integrations typically use.

Une fois que vous avez créé votre abonnement, testez soigneusement votre intégration avant de la proposer aux clients ou de l’utiliser en mode production. Pour en savoir plus, veuillez consulter la page test pour Stripe Billing.