Fonctionnement des abonnements

Les abonnements permettent aux clients d’effectuer des paiements récurrents pour accéder à un produit ou à un service. Lorsque vous créez un abonnement, Stripe génère automatiquement des factures, tente l’encaissement des paiements et gère l’état de l’abonnement tout au long de son cycle de vie. Un abonnement passe par un ensemble d’états prévisibles, de la création à l’annulation.

Contrairement aux paiements ponctuels, les abonnements nécessitent d’enregistrer les informations du client et du moyen de paiement pour les cycles de facturation futurs. Stripe gère la logique de nouvelle tentative de paiement, la relance et les transitions d’état.

Le cycle de vie d’un abonnement

Chacune des phases suivantes du cycle de vie de l’abonnement correspond à un changement d’état sur l’objet Subscription. Comprendre ces états vous permet de savoir quand fournir un accès, informer les clients et gérer les erreurs. Vous pouvez utiliser des événements de webhook pour surveiller et gérer les transitions entre chaque état.

Créer l’abonnement

Créez un nouvel abonnement dans le Dashboard ou avec l’API Subscriptions. L’objet Subscription qui en résulte contient le client abonné, le product, le price et le status reflétant l’état actuel du cycle de vie de l’abonnement.

Lorsque vous créez un abonnement qui nécessite un paiement immédiat, Stripe crée également un Invoice et un PaymentIntent. L’état initial de l’abonnement est incomplete, puis devient active après que le client a payé la première facture.

La gestion par défaut des échecs et de l’encaissement du paiement des abonnements dépend du moyen de paiement. Dans l’API, vous pouvez configurer le paramètre payment_behavior d’un abonnement pour en modifier le comportement par défaut.

Si vous créez une période d’essai pour retarder le premier paiement de l’abonnement, l’état initial est trialing, et l’abonnement passe automatiquement à l’état active lorsque l’essai se termine et que le paiement réussit.

Gérer la facture

Pour les abonnements dont le paramètre collection_method est défini sur charge_automatically, Stripe crée une facture avec l’état open lorsque vous créez l’abonnement. Votre client dispose de 23 heures pour payer. Pendant ce temps, l’état de l’abonnement est incomplete et l’état de la facture reste open. Cette fenêtre de 23 heures est prévue pour les clients qui paient pendant une session. Si le client retourne sur votre formulaire d’inscription après 23 heures, créez-lui un nouvel abonnement.

Pour les abonnements dont le paramètre collection_method est défini sur send_invoice, Stripe envoie au client un e-mail contenant un lien vers la facture avec une date d’échéance configurable. L’abonnement reste incomplete jusqu’au paiement par le client.

Pour en savoir plus, consultez la section consacrée aux factures d’abonnement.

Confirmer le paiement

Si votre client paie la facture, l’état de l’abonnement passe à active et celui de la facture à paid. Écoutez l’événement invoice.paid ou confirmez que l’état de l’abonnement est défini sur active.

Si le client ne paie pas dans les 23 heures, l’abonnement passe à incomplete_expired et la facture passe à l’état void. Pour réactiver son accès, créez un nouvel abonnement.

Pour en savoir plus, consultez les états des abonnements et des paiements.

Fournir l’accès à votre produit

Lorsqu’un abonnement devient active, Stripe crée un entitlement actif pour chaque fonctionnalité associée au produit souscrit. Lorsqu’un client accède à vos services, utilisez ses droits d’accès actifs pour lui accorder l’accès aux fonctionnalités incluses dans son abonnement.

Vous pouvez également assurer le suivi des abonnements actifs à l’aide d’événements webhook et fournir le produit au client en fonction de cette activité.

Mettre à jour l’abonnement

Vous pouvez modifier des Abonnement existantes si nécessaire sans avoir à les annuler ni à les recréer. Parmi les changements les plus importants que vous pourriez apporter, citons le passage à une offre abonnement ou inférieure ou la suspension paiement du collecter d’un abonnement actif.

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, annuler la facture d’abonnement ou marquer la facture comme irrécouvrable.

Gérer les abonnement impayés

Si le client ne paie pas une facture d’abonnement, Stripe suspend les tentatives de recouvrement ultérieures. L’abonnement continue de générer des factures à chaque période de facturation, qui conservent l’état draft. L’état de l’abonnement (past_due ou unpaid) dépend de vos paramètres d’échec de paiement dans le Dashboard.

Stripe ignore les factures annulées lors de la détermination de l’état de l’abonnement et utilise plutôt la facture non annulée la plus récente.

Pour en savoir plus, consultez la section consacrée aux Échecs des paiement d’abonnement.

Annuler l’abonnement

Vous pouvez résilier un abonnement à tout moment, y compris à la fin d’un cycle de facturation ou après un nombre défini de cycles de facturation.

Par défaut, l’annulation d’un abonnement désactive la création de nouvelles factures et arrête le recouvrement automatique de toutes les factures en souffrance de l’abonnement. Elle supprime également l’abonnement et vous ne pouvez plus le mettre à jour, à l’exception de ses metadata et cancellation_details. Si votre client souhaite se réabonner, vous devez recueillir de nouvelles informations de paiement auprès de lui et créer un nouvel abonnement.

États des abonnements

Subscriptions peuvent avoir les états suivants. Les actions que vous pouvez effectuer sur un abonnement dépendent de son état.

États des paiements

Une PaymentIntent suit le cycle de vie de chaque paiement. Lorsqu’un paiement est dû pour un abonnement, Stripe génère une facture et une PaymentIntent. L’ID de la PaymentIntent est associé à la facture et vous pouvez y accéder à partir des objets Invoice et Subscription.

L’état du PaymentIntent affecte l’état de la facture et de l’abonnement. Voici comment les différents résultats d’un paiement correspondent aux différents états :

Les moyens de paiement asynchrones, comme le prélèvement automatique ACH Direct Debit, traitent les changements d’état des abonnements différemment des paiements instantanés. Avec un moyen de paiement asynchrone, un abonnement peut passer à l’état active immédiatement après sa création sans passer par l’état incomplete. En cas d’échec de paiement ultérieur, Stripe invalide la facture, tandis que l’abonnement reste à l’état active. Adaptez votre gestion des accès et votre logique de relance en fonction de ce fonctionnement.

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 le paiement du client aboutit :

• Le status du PaymentIntent passe à succeeded.
• Le status de l’abonnement est active.
• Le status de la facture est paid.
• Stripe envoie un événement invoice.paid aux endpoints de webhook que vous avez configurés.

Pour les moyens de paiement dont la période de traiter est plus longue, les Subscriptions sont immédiatement activées. Dans ce cas, l’état de la PaymentIntent peut être processing pour un abonnement active jusqu’à ce que le paiement aboutisse.

Maintenant que votre abonnement est activé, fournissez l’accès à votre produit.

Moyen de paiement requis

Si le paiement échoue en raison d’une erreur de carte bancaire telle qu’un refus de paiement :

• Le status de la PaymentIntent est requires_payment_method.
• Le status de l’abonnement est incomplet.
• Le status de la facture est open.

Dans un tel scénario :

• Prévenez votre client.
• Collecter de nouvelles informations de paiement et confirmez le PaymentIntent.
• Mettez à jour le moyen de paiement par défaut de l’abonnement.
• Stripe effectue une nouvelle tentative de paiement à l’aide de Smart Retries ou établi vos règles de relance personnalisées.
• Utilisez l’événement invoice.payment_failed pour surveiller les échecs de paiement des abonnements et relancer les mises à jour des tentatives. 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.

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

Action requise

Certains moyens de paiement nécessitent l’authentification du client avec 3D Secure (3DS). La nécessité de l’authentification dépend de vos règles Radar et de la banque émettrice de la carte bancaire.

Si le paiement échoue parce que le client doit s’identifier un paiement :

• Le status de la PaymentIntent est requires_action.
• Le status de l’abonnement est incomplet.
• Le status de la facture est open.

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 formulaire d’inscription.
• 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.