Fonctionnement des abonnements

Avec un abonnement, le client s’acquitte de paiements récurrents en contrepartie de l’accès à un produit. Un abonnement vous amène à conserver davantage d’informations sur votre client que dans le cas d’achats ponctuels, de manière à pouvoir le débiter lors des échéances ultérieures.

Stripe propose de nombreuses fonctionnalités qui vous aident à gérer la facturation des abonnements :

• Prise en charge de différents modèles tarifaires
• Gestion des réductions sur les abonnements
• Gestion des essais
• Calculs au prorata pour les abonnements modifiés
• Gestion des clients en libre-service
• Invoicing pour collecter les paiements
• Recouvrement automatisé des revenus
• Rapports et analyses

Le cycle de vie de l’abonnement

Voici à quoi ressemble le flux d’abonnement recommandé :.

1. Créez l’abonnement. Le status de l’abonnement est défini sur incomplete si vous suivez les étapes ci-dessous. Si vous créez un abonnement sans spécifier le payment_behavior, le status par défaut est active.

2. Stripe crée automatiquement une facture à l’état open pour l’abonnement.

3. Le client paie la première facture.

4. Lorsque le paiement aboutit :

   • Le status de l’abonnement bascule sur active
   • Le status de la facture est défini sur paid
   • Stripe envoie un événement invoice.paid aux endpoints webhook que vous avez configurés

5. Vous fournissez l’accès à votre produit. Pour confirmer si la facture a été payée :

   • Configurez un endpoint webhook ou un autre type de destination d’événement et écoutez l’événement invoice.paid.
   • Vérifiez manuellement l’objet abonnement et recherchez l’état subscription.status=active. Le status devient active suite au paiement de la facture via un prélèvement automatique ou un paiement manuel de la part du client.

Le status passe à trialing si vous proposez des périodes d’essai qui ne nécessitent pas de paiement. L’état de l’abonnement devient active lorsque la période d’essai est achevée et le client abonné commence à être débité.

Comportement de paiement des abonnements

Pour simplifier la gestion des échecs de paiement, créez des abonnements en définissant payment_behavior sur default_incomplete. Vous obtenez ainsi des abonnements à l’état incomplete, et pouvez alors collecter et confirmer les données de paiement sur une seule et même interface utilisateur. Avec allow_incomplete ou error_if_incomplete, Stripe tente immédiatement de régler la facture. Si le paiement échoue, l’état de l’abonnement bascule sur incomplete ou la création échoue.

Paiements réussis

Quand le paiement de la facture par votre client aboutit, l’abonnement bascule sur active et la facture sur paid. À ce stade, vous pouvez fournir l’accès à votre produit.

Délai de paiement

Vos clients disposent d’environ 23 heures pour s’acquitter de leur paiement. Pendant ce temps, l’abonnement demeure à l’état incomplete et la facture est open. Si votre client paie la facture, l’état de l’abonnement bascule sur active et celui de la facture sur paid. Si le paiement n’est pas réalisé par le client dans le délai imparti, l’état de l’abonnement bascule sur incomplete_expired et celui de la facture sur void.

Ce délai vise à permettre à votre client de réaliser le premier paiement de son abonnement pendant une session. Si le client revient sur votre application après l’expiration du délai de 23 heures, créez-lui un nouvel abonnement.

Échecs de paiement

L’état de l’abonnement reste active tant que les paiements automatiques aboutissent. Si un paiement automatique échoue, l’état de l’abonnement bascule sur past_due et Stripe tente de recouvrer le paiement conformément à vos règles de relance. Si le recouvrement échoue, vous pouvez définir l’état de l’abonnement sur canceled, unpaid ou le laisser sur past_due.

Abonnements impayés

Pour les abonnements avec des factures impayées, ces dernières restent en cours, mais les tentatives de paiement ultérieures sont suspendues. L’abonnement continue de générer des factures à chaque cycle de facturation, qui restent à l’état draft. Pour réactiver l’abonnement :

1. Collectez de nouvelles informations de paiement si nécessaire.

2. Activez la collecte automatique en configurant auto_advance sur true pour les factures à l’état de projet.

3. Finalisez et payez les factures en cours. Le paiement de la dernière facture non annulée avant sa date d’échéance met à jour l’état de l’abonnement sur active.

Les factures marquées comme non recouvrables sont traitées comme paid lors de la détermination de l’état de l’abonnement, même si leur propriété paid reste false. Stripe ignore les factures annulées lors de la détermination de l’état de l’abonnement ; la facture non annulée la plus récente est utilisée à la place.

Le status d’un abonnement impayé dépend des paramètres relatifs aux échecs de paiement que vous avez définis dans le Dashboard.

Annuler des abonnements

L’annulation d’un abonnement entraîne la désactivation de la création de nouvelles factures et l’arrêt de l’encaissement automatique de toutes les factures liées à l’abonnement, car la valeur d’auto_advance est définie sur false. L’abonnement est également supprimé, et vous ne pouvez plus le mettre à jour ou mettre à jour ses métadonnées. Si votre client souhaite se réabonner, vous devez collecter de nouvelles informations de paiement auprès de lui et créer un nouvel abonnement.

Modifier les abonnements

Stripe prend en charge la modification des abonnements existants sans avoir à les annuler et à les recréer. Quelques-unes des principales modifications que vous pouvez apporter sont l’augmentation ou la diminution des tarifs des abonnements, l’annulation ou la suspension de l’encaissement des paiements des abonnements actifs. En savoir plus sur la modification des abonnements existants.

Gestion des sessions Checkout

Pour les intégrations Stripe Checkout, vous ne pouvez pas mettre à jour l’abonnement ou sa facture si l’abonnement de la session est incomplete. Vous pouvez écouter l’événement checkout.session.completed pour effectuer la mise à jour une fois la session terminée.

Vous pouvez également faire expirer la session si vous souhaitez annuler l’abonnement de la session, invalider la facture d’abonnement ou marquer la facture comme irrécouvrable.

Exemple d’intégration

Cette section décrit notre exemple d’intégration sur GitHub, qui illustre comment créer une intégration d’abonnements. Si vous êtes prêt à créer votre propre intégration, consultez le guide de démarrage rapide de Billing ou le guide d’intégration.

Page d’accueil

Sur votre front-end, la page d’accueil collecte prioritairement l’adresse e-mail du client. Dans votre application, il peut être judicieux de capturer d’autres informations client, telles que son nom d’utilisateur et son adresse postale. Lorsque le client clique sur le bouton d’inscription, les informations collectées sur la page d’accueil sont envoyées sur votre back-end. Un client est alors créé et la page des tarifs s’affiche sur votre front-end.

Page des tarifs

La page de tarification affiche vos options d’abonnement en fonction des produits et des tarifs que vous avez créés lors de la configuration initiale de votre intégration, ce qui signifie que vous n’avez pas besoin d’en créer de nouvelles à chaque inscription. Votre page de tarification affiche les tarifs que vous avez créés, et vos clients choisissent l’option qu’ils souhaitent. L’exemple sur GitHub affiche un formulaire de paiement lorsqu’un client sélectionne une option. En savoir plus sur les produits et les tarifs.

Paiement

Le formulaire de paiement permet de recueillir le nom du client ainsi que ses informations de carte bancaire. Stripe héberge ce formulaire si vous utilisez Checkout. Il s’agit de l’un des éléments essentiels pour l’encaissement des paiements et pour assurer votre conformité PCI. Cliquer sur le bouton S’abonner entraîne les actions suivantes :

1. Un nouvel abonnement est créé avec les ID du client et du tarif.
2. Génère une facture pour votre cycle d’abonnement initial.
3. Les informations de paiement sont collectées et la facture est payée.
4. Définissez le moyen de paiement comme moyen de paiement par défaut pour l’abonnement. Cette action est nécessaire pour les paiements ultérieurs.

Assurez-vous de confirmer le paiement avant de fournir l’accès à votre client.

Pour implémenter ceci :

• Accepter des paiements sans rédiger de code : si vous ne souhaitez pas écrire de code, découvrez comment créer un lien de paiement et le partager avec vos clients.
• **Créer une page de paiement ** : utilisez l’API Checkout Sessions pour accepter des paiements par le biais d’une page hébergée, d’un formulaire intégré à votre site ou d’une page de paiement personnalisée comportant des composants intégrés.
• Intégration avancée : utilisez Stripe Elements pour collecter les informations de paiement et activer l’abonnement avec le composant Payment Element.

Mise en service

Utilisez les droits d’accès pour déterminer quand vous pouvez accorder ou révoquer l’accès aux fonctionnalités d’un produit à vos clients. Une fois le paiement réussi, vous pouvez également mettre le produit à disposition du client en toute sécurité. Cela signifie généralement :

1. Vérifier que l’état de l’abonnement est active.
2. Accorder au client l’accès aux produits et fonctionnalités inclus dans son abonnement.

Découvrez comment utiliser les destinations d’événements pour :

• Suivre les abonnements actifs
• Gérer les échecs de paiement
• Vérifier les objets d’événements

Fonctionnement des paiements avec les abonnements

Pour simplifier la gestion des échecs de paiement et pour créer des abonnements avant toute tentative de paiement :

1. Transmettez payment_behavior=default_incomplete lors de la création d’un abonnement. Si un paiement est requis, l’abonnement est créé avec l’état incomplete. Sinon, votre abonnement est immédiatement active.

2. Activez un abonnement incomplet en payant la première facture.

3. Transmettez l’identifiant du PaymentIntent correspondant à la facture à votre interface utilisateur pour collecter les informations de paiement et confirmer le PaymentIntent. Vous pouvez utiliser Elements, le SDK Android ou le SDK iOS.

Paiements récurrents

Stripe gère automatiquement les paiements récurrents :

• Stripe facture automatiquement les clients et tente de finaliser les paiements lorsqu’un nouveau cycle de facturation commence.
• Lorsqu’un paiement échoue, Stripe le relance à l’aide de la fonctionnalité Smart Retries ou de votre calendrier de relance personnalisé. Ainsi, lorsqu’une carte est refusée, une nouvelle tentative de paiement est effectuée selon les paramètres du Dashboard. Si un échec renvoie un code de refus définitif, les tentatives programmées se poursuivent, mais le paiement n’est effectué que si vous utilisez un nouveau moyen de paiement.

Vous pouvez envoyer un e-mail de relance aux clients qui ont des paiements en souffrance afin d’augmenter les chances de recouvrement. Pour les paiements qui nécessitent 3D Secure, vous pouvez configurer vos paramètres de facturation de manière à envoyer un lien hébergé aux clients pour leur permettre de terminer le tunnel de paiement.

État du paiement

Le processus de paiement diffère selon le moyen de paiement utilisé et la zone géographique. Les paiements peuvent par ailleurs initialement échouer (par exemple, si le client a saisi un numéro de carte erroné ou si ses fonds sont insuffisants). Différents résultats sont donc possibles pour un même paiement.

Un PaymentIntent filière le cycle de vie de chaque paiement. Dès qu’un paiement arrive à échéance pour un abonnement, Stripe génère une facture et un PaymentIntent. L’ID du PaymentIntent est associé à la facture et vous pouvez y accéder depuis les objets Invoice et Subscription. L’état du PaymentIntent affecte l’état de la facture et de l’abonnement. Voici les correspondances entre les différents résultats et états d’un paiement :

Les sections suivantes expliquent ces différents états et précisent les actions à mettre en œuvre pour chacun d’entre eux.

Paiement réussi

Lorsque votre paiement aboutit, le PaymentIntent est à l’état succeeded, et l’abonnement devient active. Pour les moyens de paiement avec des périodes de traitement plus longues, les abonnements sont immédiatement activés. Dans ces cas-là, le PaymentIntent peut être à l’état processing pour un abonnement active jusqu’à ce que le paiement aboutisse.

Maintenant que votre abonnement est activé, fournissez l’accès à votre produit. Consultez le guide pour en savoir plus sur le cycle de vie d’un abonnement et les bonnes pratiques concernant la mise en service.

{
  "id": "sub_1ELI8bClCIKljWvsvK36TXlC",
  "object": "subscription",
  "status": "active",
  ...
  "latest_invoice": {
    "id": "in_EmGqfJMYy3Nt9M",
    "status": "paid",
    "payments": {
      "data": [
        {
          "payment": {
            "type": "payment_intent",
            "payment_intent": {
              "status": "succeeded",
              ...
            }
          }
          ...
        }
      ],
    ...
  }
}

Moyen de paiement requis

Si le paiement échoue en raison d’une erreur de carte, un refus de paiement par exemple, l’état du PaymentIntent bascule sur requires_payment_method et celui de l’abonnement sur incomplete.

{
  "id": "sub_1ELI8bClCIKljWvsvK36TXlC",
  "object": "subscription",
  "status": "incomplete",
  ...
  "latest_invoice": {
    "id": "in_EmGqfJMYy3Nt9M",
    "status": "open",
    "payments": {
      "data": [
        {
          "payment": {
            "type": "payment_intent",
            "payment_intent": {
              "status": "requires_payment_method",
              ...
            }
          }
          ...
        }
      ],
      ...
    }
  }
}

Dans un tel scénario :

• Prévenez votre client.
• Recueillez de nouvelles données de paiement et confirmez le PaymentIntent.
• Mettez à jour le moyen de paiement par défaut de l’abonnement.

Découvrez comment gérer les échecs de paiement dans le cadre d’un abonnement.

Action requise

Certains moyens de paiement requièrent l’authentification du client avec 3D Secure (3DS) pour finaliser le processus de paiement. Si vous utilisez l’API Payment Intents, la valeur status du PaymentIntent est définie sur requires_action lorsqu’un client doit authentifier un paiement. Vous pouvez obtenir le PaymentIntent sur la ressource Invoice Payment en développant latest_invoice.payments.data.payment.payment_intent ou en spécifiant le paramètre de facture avec la liste des PaymentIntent. 3DS finalise le processus d’authentification. L’authentification d’un moyen de paiement dépend de vos règles Radar et de la banque émettrice de la carte.

Les réglementations en vigueur en Europe imposent souvent le recours à 3D Secure. Consultez la rubrique consacrée à l’authentification forte du client pour déterminer si la gestion de cet état est importante dans votre cas. Si vous disposez d’une intégration de facturation existante et souhaitez ajouter la prise en charge de ce flux, reportez-vous également au guide de migration SCA pour Billing.

{
  "id": "sub_1ELI8bClCIKljWvsvK36TXlC",
  "object": "subscription",
  "status": "incomplete",
  ...
  "latest_invoice": {
    "id": "in_EmGqfJMYy3Nt9M",
    "status": "open",
    ...
    "payments": {
      "data": [
        {
          "payment": {
            "type": "payment_intent",
            "payment_intent": {
              "status": "requires_action",
              "client_secret": "pi_91_secret_W9",
              "next_action": {
                "type": "use_stripe_sdk",
                ...
              },
              ...
            }
          }
          ...
        }
      ],
    }
  }
}

Dans un tel scénario :

• Surveillez la notification d’événement invoice.payment_action_required à l’aide des endpoints de webhook. Cela indique qu’une authentification est requise.
• Avertissez votre client qu’une authentification est requise.
• Récupérez la clé secrète du client pour le PaymentIntent et transmettez-la dans un appel à stripe.ConfirmCardPayment. Cette action entraîne la présentation d’une fenêtre modale d’authentification à vos clients, une tentative de paiement, puis la fermeture de la fenêtre modale et le renvoi du contexte à votre application.
• Surveillez l’événement invoice.paid sur votre destination d’événement pour vérifier que le paiement a abouti. Les utilisateurs peuvent quitter votre application avant que la fonction confirmCardPayment() ne se termine. Le fait de vérifier que le paiement a abouti vous permet de fournir l’accès à votre produit de manière adéquate.

États des abonnements

Paramètres et récupération des abonnements

Vos paramètres d’abonnement déterminent la manière dont Stripe traite les échecs de paiement et les expirations d’abonnement.

Smart Retries

Après avoir créé un abonnement, l’échec de paiement est l’événement le plus important qui peut se produire. Les échecs peuvent survenir pour de nombreuses raisons :

• Aucun moyen de paiement n’est associé au client.
• Le moyen de paiement a expiré.
• Le paiement est refusé.

Vous pouvez configurer Stripe pour relancer les paiements en échec pendant deux mois maximum dans Gérer les échecs de paiement des Subscriptions dans le Dashboard. Smart Retries utilise l’IA pour choisir le moment optimal pour les relances sur la période configurée.

Vous pouvez également modifier le calendrier des relances avec des règles personnalisées. Vous pouvez configurer jusqu’à trois relances en précisant pour chacune quand elle doit intervenir, en nombre de jours après la tentative précédente.

Vous pouvez utiliser l’événement invoice.payment_failed pour surveiller les événements d’échec de paiement d’un abonnement et les mises à jour des tentatives de relance. Après une tentative de paiement sur une facture, sa valeur next_payment_attempt est définie à l’aide des paramètres d’abonnement actuels dans votre Dashboard.

Si le recouvrement échoue, l’abonnement est modifié selon vos paramètres. Vous pouvez choisir de :

Après la dernière tentative de paiement, nous n’effectuons plus aucune relance. La modification des paramètres de votre abonnement n’a d’incidence que sur les tentatives futures.

E-mails

Si vous le souhaitez, Stripe peut envoyer différents e-mails aux clients à l’aide des adresses e-mail associées à l’objet Customer :

• Un rappel de renouvellement à venir que nous envoyons en même temps que l’événement invoice.upcoming pour les abonnements configurés de façon à encaisser le paiement automatiquement.
• Une notification d’échec de paiement invitant les clients à mettre à jour leurs informations de paiement. Découvrez comment activer les notifications d’échec de paiement.
• Une notification d’expiration lorsqu’une carte default_source d’un de vos clients arrive à expiration.

Vous pouvez personnaliser les logos et les couleurs que vos clients voient dans leurs e-mails, ainsi que sur notre page de paiement de facture hébergée, en modifiant les paramètres de marque dans le Dashboard.

Périodes d’essai

Les réseaux de cartes exigent que vous informiez vos clients de leurs essais. Stripe peut gérer cette communication pour vous. Dans le Dashboard, vous pouvez configurer l’URL d’annulation qui figure à la fois sur les e-mails de rappel et sur le reçu de la première facture après la fin d’une période d’essai. Vous pouvez également configurer le libellé de relevé bancaire pour le premier débité après une période d’essai. Pour en savoir plus sur ces exigences et paramètres, consultez la page des essais.

Postes d’abonnement

Utilisez les principales ressources d’API suivantes pour créer et gérer des abonnements :

Voici un exemple de la manière dont les produits, les fonctionnalités et les droits d’accès fonctionnent ensemble. Imaginons que vous créez un service d’abonnement proposant deux niveaux : un produit standard avec des fonctionnalités de base et un produit avancé qui ajoute des fonctionnalités étendues.

1. Vous créez deux fonctionnalités : basic_features et extended_features.
2. Vous créez deux produits : standard_product et advanced_product.
3. Pour le produit standard, vous créez un objet ProductFeature qui associe basic_features à standard_product.
4. Pour le produit avancé, vous créez deux objets ProductFeature : un qui associe basic_features à advanced_product et un qui associe extended_features à advanced_product.

Un client, first_customer, s’abonne au produit standard. Lorsque vous créez l’abonnement, Stripe crée automatiquement un objet Entitlement qui associe first_customer à basic_features.

Un autre client, second_customer, s’abonne au produit avancé. Lorsque vous créez l’objet Subscription correspondant, Stripe crée automatiquement deux objets Entitlement : un qui associe second_customer à basic_features, et un qui associe second_customer à extended_features.

Pour savoir quelles fonctionnalités vous devez fournir à un client, récupérez ses droits d’accès actifs ou écoutez l’événement Active Entitlement Summary. Il n’est pas nécessaire de récupérer ses abonnements, produits et fonctionnalités.

Événements d’abonnement

Des événements sont déclenchés chaque fois qu’un abonnement est créé ou modifié. Nous envoyons certains événements dès la création de l’abonnement, tandis que d’autres se répètent régulièrement à l’occasion de chaque facturation. Nous vous recommandons d’écouter les événements à l’aide des endpoints de webhook.

Veillez à ce que votre intégration gère les événements de manière adéquate. Par exemple, vous pouvez envoyer un e-mail à votre client en cas d’échec de paiement ou révoquer son accès s’il annule son abonnement.

Consultez la page Événements d’abonnement pour obtenir la liste des événements les plus courants liés aux abonnements et, le cas échéant, des suggestions d’actions pour gérer les événements.