Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous

Créer des abonnements avec Stripe Billing

Grâce à Connect, vous pouvez créer des abonnements pour vos clients ou des comptes connectés.

Copier la page

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.

Cas d’usageDescription
Abonner le client final au compte connectéCréez des abonnements à vos comptes connectés pour les clients finaux, ce qui permet de collecter les paiements de plusieurs façons. Dans cet exemple, les tarifs se trouvent sur le compte connecté.
Créer des abonnements pour facturer les clients finaux de la plateformeLes places de marché peuvent proposer des abonnements sans faire intervenir votre compte connecté. Dans cet exemple, les tarifs se trouvent sur la plateforme.
Créer des abonnements pour facturer des comptes connectésLes plateformes peuvent créer des abonnements pour leurs comptes connectés. Dans cet exemple, les tarifs se trouvent sur la plateforme.

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.
  • 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.

Command Line
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.

Command Line
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.

Eventdata.object typeDescription
account.application.deauthorizedapplicationOccurs when a connected account disconnects from your platform. You can use it to trigger cleanup on your server. Available for connected accounts with access to the Stripe Dashboard, which includes Standard accounts.
account.external_account.updatedAn external account, such as card or bank_accountOccurs when a bank account or debit card attached to a connected account is updated, which can impact payouts. Available for connected accounts that your platform controls, which includes Custom and Express accounts, and Standard accounts with platform controls enabled.
account.updatedaccountAllows you to monitor changes to connected account requirements and status changes. Available for all connected accounts.
balance.availablebalanceOccurs when your Stripe balance has been updated. For example, when funds you’ve added from your bank account are available for transfer to your connected account.
payment_intent.succeededpayment_intentOccurs when a payment intent results in a successful charge. Available for all payments, including destination and direct charges.
payout.failedpayoutOccurs when a payout fails. When a payout fails, the external account involved is disabled, and no automatic or manual payouts can be processed until the external account is updated.
person.updatedpersonOccurs when a Person associated with the Account is updated. If you use the Persons API to handle requirements, listen for this event to monitor changes to requirements and status changes for individuals. Available for connected accounts that your platform controls, which includes Custom and Express accounts, and Standard accounts with platform controls enabled.

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

customer.createdEnvoyé lorsqu’un objet Customer a bien été créé.
customer.subscription.createdEnvoyé lors de la création de l’abonnement. Le status de l’abonnement peut être incomplete si l’authentification du client est demandée pour mener à bien le paiement ou si vous définissez payment_behavior sur default_incomplete. Familiarisez-vous avec le comportement de paiement des abonnements pour en savoir plus.
customer.subscription.deletedEnvoyé lorsque l’abonnement d’un client prend fin.
customer.subscription.pausedEnvoyé lorsque le status d’un abonnement passe à paused. Par exemple, l’événement est envoyé lorsqu’un abonnement est configuré pour être suspendu lorsqu’un essai gratuit prend fin sans moyen de paiement. La facturation n’aura pas lieu tant que l’abonnement n’aura pas repris. Nous n’envoyons pas cet événement si l’encaissement des paiements est suspendu, car des factures continuent d’être créées pendant cette période.
customer.subscription.resumedEnvoyé lors de la reprise d’un abonnement qui était à l’état paused. Cela ne s’applique pas lorsque l’encaissement des paiements est réactivé.
customer.subscription.trial_will_endEnvoyé trois jours avant la fin de la période d’essai. Si la période d’essai est inférieure à trois jours, l’événement est déclenché.
customer.subscription.updatedEnvoyé lorsqu’un abonnement démarre ou est modifié. Par exemple, le renouvellement d’un abonnement, l’ajout d’un bon de réduction, l’application d’une réduction, l’ajout d’un poste de facture et le changement de plan déclenchent sont des situations qui déclenchent cet événement.
entitlements.active_entitlement_summary.updatedEnvoyé lorsque les droits actifs d’un client sont mis à jour. Lorsque vous recevez cet événement, vous pouvez donner ou retirer l’accès aux fonctionnalités de votre produit. En savoir plus sur l’intégration des droits.
invoice.createdEnvoyé lorsqu’une facture est créée pour un nouvel abonnement ou un renouvellement. Si Stripe ne reçoit pas une réponse positive à invoice.created, la finalisation de toutes les factures avec l’encaissement automatique est retardée de 72 heures au maximum. Renseignez-vous sur la finalisation des factures.
invoice.finalizedEnvoyé lorsqu’une facture est finalisée et prête à être payée.
  • Vous pouvez envoyer la facture au client. Familiarisez-vous avec la finalisation des factures pour en savoir plus.
  • Selon vos paramètres, nous débitons automatiquement le moyen de paiement par défaut ou tentons un encaissement. Renseignez-vous sur les e-mails après la finalisation pour en savoir plus.
invoice.finalization_failedLa facture n’a pas pu être finalisée. Reportez-vous à la page consacrée à la gestion des échecs de finalisation des factures. Davantage d’informations à propos de la finalisation des factures sont disponibles dans le guide de présentation générale des factures.
  • Inspectez e champ last_finalization_error de l’objet Invoice pour déterminer la cause de l’erreur.
  • Si vous utilisez Stripe Tax, vérifiez le champ automatic_tax de l’objet Invoice.
  • Si automatic_tax[status]=requires_location_inputs, la facture ne peut pas être finalisée et les paiements ne sont pas perçus. Prévenez votre client et collectez la localisation du client demandée.
  • Si automatic_tax[status]=failed, relancez la requête plus tard.
invoice.paidEnvoyé lorsque la facture est réglée. Vous pouvez fournir l’accès à votre produit dès la réception de cet événement et le basculement du status de l’abonnement sur active.
invoice.payment_action_requiredEnvoyé lorsque la facture nécessite une authentification du client. Découvrez comment gérer un abonnement quand une action est requise pour la facture.

invoice.payment_failed

Le paiement d’une facture a échoué. L’état du PaymentIntent bascule sur requires_action. L’état de l’abonnement reste incomplete seulement pour la première facture de l’abonnement. Lorsqu’un paiement échoue, plusieurs actions sont possibles :

invoice.upcomingEnvoyé quelques jours avant le renouvellement de l’abonnement. Le nombre de jours dépend de la valeur Événements de renouvellement à venir configurée dans le Dashboard. Pour les abonnements existants, la modification du nombre de jours prend effet à la période de facturation suivante. Vous pouvez toujours ajouter des postes de facture supplémentaires si nécessaire.
invoice.updatedEnvoyé lorsqu’un paiement aboutit ou échoue. Si le paiement aboutit, l’attribut paid est défini sur true et le status sur paid. Si le paiement échoue, paid est défini sur false et le status reste open. Les échecs de paiement déclenchent par ailleurs un événement invoice.payment_failed.
payment_intent.createdEnvoyé lorsqu’un PaymentIntent est créé.
payment_intent.succeededEnvoyé lorsqu’un PaymentIntent a effectué un paiement avec succès.
subscription_schedule.abortedEnvoyé lorsqu’une planification d’abonnement est annulée car un défaut de paiement a entraîné la résiliation de l’abonnement correspondant.
subscription_schedule.canceledEnvoyé lorsqu’une planification d’abonnement est annulée, ce qui annule également tout abonnement actif associé.
subscription_schedule.completedEnvoyé lorsque toutes les phases d’une planification d’abonnement sont terminées.
subscription_schedule.createdEnvoyé lorsqu’une nouvelle planification d’abonnement est créée.
subscription_schedule.expiringEnvoyé 7 jours avant la date d’expiration d’un abonnement.
subscription_schedule.releasedEnvoyé lorsqu’une planification d’abonnement est publiée, ou interrompue et dissociée de l’abonnement, lequel est conservé.
subscription_schedule.updatedEnvoyé lorsqu’une planification d’abonnement est mise à jour.

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.

Encaisser des frais sur les abonnements

Utiliser des bons de réduction

Utiliser des périodes d'essai

Configurer le portail client

Surveiller les abonnements avec des webhooks

Configurer le compte connecté en tant qu'entité de règlement à l'aide du paramètre on_behalf_of

Comprendre le comportement de déconnexion

Intégrer le calcul et la collecte des taxes

Voir aussi

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc