Créer des abonnements avec Stripe Billing

Les SaaS (Software as a Service) et les places de marché ont recours à Stripe Connect pour acheminer les paiements entre leur plateforme, les clients et les comptes connectés. Vous pouvez utiliser Connect pour acheminer des paiements ou des virements et Stripe Billing pour prendre en charge votre modèle de revenus récurrents.

Cas d’usage

Vous pouvez créer des abonnements pour des comptes Connect, avec plusieurs approches d’encaissement des paiements prises en charge. Vous pouvez créer des abonnements pour les clients de vos comptes connectés en utilisant des paiements directs ou indirects, pour que vos clients finaux puissent traiter des transactions directement avec votre plateforme et débiter vos comptes connectés de frais d’utilisation de votre plateforme.

Les cas d’usage suivants expliquent comment utiliser Stripe Billing pour créer des abonnements depuis les clients finaux aux comptes connectés, pour facturer les clients finaux de la plateforme et les comptes connectés.

Restrictions

Les restrictions suivantes s’appliquent à l’utilisation de Connect pour les abonnements :

• Votre plateforme ne peut pas modifier ni annuler un abonnement qu’elle n’a pas créé.
• Votre plateforme ne peut pas ajouter un application_fee_amount à une facture qu’elle n’a pas créée, ou à une facture contenant des postes qu’elle n’a pas créés.
• Seuls les comptes connectés ayant accès à l’intégralité du Dashboard Stripe peuvent gérer les abonnements de leurs clients. Pour les autres comptes connectés, la plateforme doit gérer les abonnements de leurs clients.
• Les abonnements ne sont pas automatiquement annulés lorsque vous vous déconnectez de la plateforme. Vous devez annuler l’abonnement après votre déconnexion. Vous pouvez utiliser des webhooks pour surveiller l’activité du compte connecté.

Créer des abonnements pour le client final d’un compte connecté

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.confirmation_secret pour inclure le Payment Element, dont vous avez besoin pour confirmer le paiement. Pour en savoir plus, veuillez consulter la section Payment Element.

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.confirmation_secret"

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.confirmation_secret pour inclure le Payment Element, dont vous avez besoin pour confirmer le paiement. Pour en savoir plus, veuillez consulter la section Payment Element.

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.confirmation_secret" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

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

Pour créer un paiement indirect, définissez à 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. Lorsque vous utilisez des paiements indirects, la plateforme est le marchand officiel.

Créer des abonnements pour facturer les clients finaux 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.

Créer des abonnements pour facturer des comptes connectés

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.

Activer votre intégration pour recevoir des notifications d’événement

Stripe crée des notifications d’événement lorsque des changements sont apportés à votre compte, par exemple lorsqu’un paiement récurrent aboutit ou qu’un virement échoue. Afin de recevoir ces notifications et les utiliser pour automatiser votre intégration, configurez un endpoint de webhook. Par exemple, vous pouvez donner accès à votre service lorsque vous recevez l’événement invoice.paid.

Notifications d’événements pour Connect et les intégrations d’abonnements

Voici les notifications d’événements généralement utilisées par les intégrations Connect.

Voici les notifications d’événements généralement utilisées par les intégrations d’abonnements.

Tester votre intégration

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.

Options supplémentaires

Après avoir créé votre abonnement, vous pouvez entre autres indiquer un application_fee_percent, configurer le portail client, facturer votre client à l’aide du paramètre on_behalf_of et surveiller les abonnements avec des webhooks, en plus d’autres options.

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

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

curl https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d application_fee_amount=100 \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

curl https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d application_fee_amount=100 \
  -d "transfer_data[destination]"="{{CONNECTED_STRIPE_ACCOUNT_ID}}"

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

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d trial_end=now

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

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d application_fee_percent=10 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}}