Fonctionnement des abonnements
Comment gérer les paiements récurrents et les cycles de vie 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.
Postes d’abonnement
Utilisez les principales ressources d’API suivantes pour créer et gérer des abonnements :
Ressource | Définition |
---|---|
Customer | Représente un client qui achète un abonnement. Utilisez l’objet Customer associé à un abonnement pour effectuer et suivre ses paiements récurrents et gérer les produits auxquels il est abonné. |
Entitlement | Représente l’accès d’un client à une fonctionnalité incluse dans un produit de service auquel il est abonné. Lorsque vous créez un abonnement représentant l’achat récurrent d’un produit par un client, un droit d’accès actif est automatiquement créé pour chaque fonctionnalité associée à ce produit. Lorsqu’un client accède à vos services, utilisez ses droits d’accès actifs pour activer les fonctionnalités incluses dans son abonnement. |
Feature | Représente une fonctionnalité à laquelle vos clients peuvent accéder lorsqu’ils s’abonnent à un produit de service. Vous pouvez inclure des fonctionnalités dans un produit en créant des objets ProductFeatures. |
Invoice | Relevé des montants dus par un client et qui suit les états des paiements, de l’ébauche initiale au paiement ou à la finalisation. Les abonnements génèrent automatiquement des factures. |
PaymentIntent | Un moyen de créer des tunnels de paiement dynamiques. Un PaymentIntent suit le cycle de vie du tunnel de paiement d’un client et déclenche des étapes d’authentification supplémentaires lorsque des mandats réglementaires, des règles Radar personnalisées de lutte contre la fraude, ou des moyens de paiement avec redirection l’exigent. Les objets Invoice créent automatiquement des PaymentIntents. |
PaymentMethod | Les instruments de paiement qu’un client utilise pour payer vos produits. Vous pouvez par exemple enregistrer une carte bancaire dans un objet Customer et l’utiliser pour les paiements récurrents de ce client. Généralement utilisés avec les API Payment Intents ou Setup Intents. |
Price | Définit le tarif unitaire, la devise et le cycle de facturation d’un produit. |
Product | Un bien ou un service que votre entreprise vend. Un produit de service peut comporter une ou plusieurs fonctionnalités. |
ProductFeature | Représente l’inclusion d’une fonctionnalité unique dans un produit unique. Chaque produit est associé à un objet ProductFeature pour chaque fonctionnalité qu’il inclut, et chaque fonctionnalité est associée à un objet ProductFeature pour chaque produit qui l’inclut. |
Subscription | Représente l’achat récurrent et programmé d’un produit par un client. L’abonnement permet d’encaisser des paiements et de fournir des livraisons répétées ou un accès continu à un produit. |
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.
- Vous créez deux fonctionnalités :
basic_
etfeatures extended_
.features - Vous créez deux produits :
standard_
etproduct advanced_
.product - Pour le produit standard, vous créez un objet ProductFeature qui associe
basic_
àfeatures standard_
.product - Pour le produit avancé, vous créez deux objets ProductFeature : un qui associe
basic_
àfeatures advanced_
et un qui associeproduct extended_
àfeatures advanced_
.product
Un client, first_
, s’abonne au produit standard. Lorsque vous créez l’abonnement, Stripe crée automatiquement un objet Entitlement qui associe first_
à basic_
.
Un autre client, second_
, s’abonne au produit avancé. Lorsque vous créez l’objet Subscription correspondant, Stripe crée automatiquement deux objets Entitlement : un qui associe second_
à basic_
, et un qui associe second_
à extended_
.
You can determine which features to provision for a customer by retrieving their active entitlements or listening to the Active Entitlement Summary event. You don’t have to retrieve their subscriptions, products, and features.
Exemple d’intégration
Cette section décrit notre exemple d’intégration sur GitHub, qui illustre la façon de créer une intégration pour les abonnements. Si vous êtes prêt à concevoir votre propre intégration, consultez notre QuickStart consacré à Billing ou notre 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 des tarifs affiche vos options d’abonnement compte tenu des produits et tarifs que vous avez créés lors de la configuration initiale de votre intégration, ce qui signifie que vous n’avez pas à les définir à chaque inscription d’un client. Cette page affiche les tarifs que vous avez créés, et vos clients choisissent l’option qui leur convient. 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 :
- Un nouvel abonnement est créé avec les ID du client et du tarif.
- Une facture est générée pour votre cycle d’abonnement initial.
- Les informations de paiement sont collectées et la facture est payée.
- 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.
Note
Confirmer le paiement avant de fournir l’accès à votre client.
Pour implémenter ceci :
- Sans code : si vous ne souhaitez pas rédiger de code, découvrez comment créer un lien de paiement et le partager avec vos clients.
- Low-code : si vous utilisez Checkout, découvrez comment ajouter un bouton à votre site Web qui crée une session Checkout.
- Code personnalisé : si vous utilisez Elements, découvrez comment collecter les données de paiement de votre client et activer l’abonnement avec le Payment Element ou le Card Element.
Mise en service
Utilisez les droits d’accès pour déterminer quand vous pouvez accorder à vos clients l’accès aux fonctionnalités de vos produits et quand vous pouvez le révoquer.
Par ailleurs, une fois qu’un paiement aboutit, vous pouvez mettre le produit à la disposition du client en toute sécurité. En général, vous devez :
- Vérifier que l’état de l’abonnement est
active
. - 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 :
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 :
- 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édiatementactive
. - Activez un abonnement incomplet en payant la première facture.
- 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.
É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 suit 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 :
Résultat du paiement | État du PaymentIntent | État de la facture | État de l’abonnement |
---|---|---|---|
Opération réussie | succeeded | paid | active |
Échecs dus à une erreur de carte bancaire | requires_ | open | incomplete |
Échecs d’authentification | requires_ | open | incomplete |
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.
Réponse | Abonnement | PaymentIntent |
---|---|---|
| active | 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_
et celui de l’abonnement sur incomplete
.
Réponse | Abonnement | PaymentIntent |
---|---|---|
| incomplete | 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
Pour certains moyens de paiement, une authentification du client avec 3D Secure (3DS) est requise pour mener à bien le processus de paiement. Si vous utilisez l’API Payment Intents, latest_
est défini sur requires_
lorsqu’un client doit authentifier un paiement. 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.
Réponse | Abonnement | PaymentIntent |
---|---|---|
| incomplete | requires_action |
Dans un tel scénario :
- Surveillez la notification d’événement
invoice.
à l’aide de destinations d’événements. Celle-ci indique qu’une authentification est requise.payment_ action_ required - 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.
sur votre destination d’événement pour vérifier que le paiement a abouti. Les utilisateurs peuvent quitter votre application avant que la fonctionpaid 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.
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 en accord avec les paramètres du Dashboard. Si un échec renvoie un code de refus sans relance possible, 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.
Développer votre propre gestion des échecs pour les paiements récurrents
Si vous ne voulez pas utiliser l’outil de gestion des échecs de Stripe, vous pouvez développer le vôtre. Si un paiement échoue ou qu’il nécessite une authentification du client, le status
de l’abonnement est défini sur past_
et l’état du PaymentIntent bascule sur requires_
ou requires_
.
Dans un tel scénario, configurez une destination d’événement et écoutez l’événement customer.subscription.updated pour recevoir une notification lorsque l’état d’un abonnement passe à past_
:
{ "id": "sub_E8uXk63MAbZbto", "object": "subscription", ... "status": "past_due", "latest_invoice": "in_1EMLu1ClCIKljWvsfTjRFAxa" }
Pour ces abonnements, vos clients doivent revenir sur votre application pour renseigner un autre moyen de paiement et effectuer le paiement. Pour cela, vous pouvez leur envoyer un e-mail ou une notification Push sur leur téléphone portable. Stripe propose des e-mails de rappel intégrés à cet effet, que vous pouvez configurer dans vos paramètres de facturation.
Quand votre client revient sur votre application, réutilisez le flux des échecs de paiement ou le flux des actions du client, selon l’état du PaymentIntent associé. Une fois le paiement réalisé, l’état de l’abonnement est active
et celui de la facture est paid
.
Gérer les factures sans paiement
Les abonnements qui prévoient une période d’essai, une facturation à l’usage ou l’application aux factures de bons de réduction ou du solde créditeur du client donnent souvent lieu à des factures sans paiement. Ceci signifie que vous ne débitez pas immédiatement le client lorsque vous créez l’abonnement.
Même si vous ne débitez pas vos clients pour la première facture, l’authentification et l’autorisation de leur carte bancaire restent souvent des étapes pertinentes, en ceci que vos chances de voir ensuite le premier paiement non-nul aboutir s’en trouvent accrues. Les paiements effectués de cette façon sont appelés paiements hors session. Pour gérer ces scénarios, Stripe a créé les SetupIntents.
Utilisation de SetupIntents
Vous pouvez utiliser les SetupIntents pour :
- Collecter les informations de paiement.
- Authentifier la carte bancaire de votre client afin de solliciter des exemptions ultérieurement.
- Autoriser la carte bancaire de votre client sans la débiter.
L’authentification des paiements permet à votre client d’autoriser le débit de sa carte. Cette opération est nécessaire pour une authentification forte du client et est souvent menée à bien avec 3DS. La collecte des informations du moyen de paiement et son autorisation sont nécessaires pour que vous puissiez débiter le moyen de paiement.
Dans les scénarios hors session, les SetupIntents vous permettent de débiter le premier paiement non-nul d’un client sans nécessité de le faire revenir sur votre site Web ou votre application pour une authentification. Ils fluidifient ainsi le processus pour le client.
Le champ pending_
d’un abonnement n’est pas automatiquement annulé à la fin de l’abonnement. Écoutez les événements customer.
et annulez manuellement le SetupIntent d’abonnement si nécessaire.
Stripe crée automatiquement des SetupIntents pour les abonnements qui ne nécessitent pas de paiement initial. Les processus d’authentification et d’autorisation sont également exécutés à ce stade, s’ils sont nécessaires. Si ces deux étapes aboutissent ou si elles ne sont pas nécessaires, aucune action n’est requise et le champ subscription.
prend la valeur null
. Dès lors que l’une de ces étapes échoue, Stripe vous recommande d’utiliser le SetupIntent sur votre front-end afin de résoudre le problème pendant que votre client est en session. Les deux sections suivantes expliquent en détail comment gérer les cas où l’authentification ou l’autorisation échoue.
Gérer les échecs d’authentification Côté client
Les échecs d’authentification se produisent lorsque Stripe ne parvient pas à authentifier votre client auprès de l’émetteur de sa carte bancaire. Dans ce cas, le status
du SetupIntent est défini sur requires_
.
Dans un tel scénario, appelez confirmCardSetup sur votre front-end pour que votre client suive le flux d’authentification manuellement. L’exemple de code ci-dessous développe le pending_
pour l’exécution du flux.
const {pending_setup_intent} = subscription; if (pending_setup_intent) { const {client_secret, status} = subscription.pending_setup_intent; if (status === "requires_action") { const {setupIntent, error} = await stripe.confirmCardSetup(client_secret); if (error) { // Display error.message in your UI. } else { // The setup has succeeded. Display a success message. } } }
Une fois ce flux terminé, l’autorisation s’exécute si nécessaire. Si l’autorisation aboutit ou si elle n’est pas requise, pending_
bascule alors sur null
.
Gérer les échecs d’autorisation Côté client
Un échec d’autorisation de paiement se produit lorsque Stripe ne peut pas vérifier qu’une carte bancaire peut être débitée. Dans ce cas, le status
du SetupIntent est défini sur requires_
. En général, cela signifie que les paiements suivants effectués avec cette carte échoueront également.
Dans un tel scénario, collectez un nouveau moyen de paiement, puis mettez à jour le moyen de paiement par défaut de votre client ou de l’abonnement. L’exemple de code ci-dessous développe le paramètre pending_
pour l’exécution du flux.
const {pending_setup_intent, latest_invoice} = subscription; if (pending_setup_intent) { const {client_secret, status} = subscription.pending_setup_intent; if (status === "requires_action") { const {setupIntent, error} = await stripe.confirmCardSetup(client_secret); if (error) { // Display error.message in your UI. } else { // The setup has succeeded. Display a success message. } } else if (status === "requires_payment_method") { // Collect new payment method } }
Le cycle de vie de l’abonnement
Voici à quoi ressemble le flux d’abonnement recommandé :.
- Vous créez l’abonnement. Le
status
de l’abonnement est défini surincomplete
(si vous suivez le flux recommandé, c’est-à-dire si vous créez un abonnement sans spécifier lepayment_
et que lebehavior status
par défaut estactive
). - Une facture est créée pour l’abonnement. Le
status
de la facture estopen
. - Le client paie la première facture.
- Lorsque le paiement aboutit :
- Le
status
de l’abonnement bascule suractive
- Le
status
de la facture est défini surpaid
- Stripe envoie un événement
invoice.
aux destinations d’événements que vous avez configurées.paid
- Le
- Vous fournissez l’accès à votre produit. Vous pouvez confirmer si la facture a été payée en :
- Mise en place d’une destination d’événement et écoute de l’événement
invoice.
.paid - Vérifiant manuellement l’objet Subscription et en recherchant l’état
subscription.
. Lestatus=active status
devientactive
suite au paiement de la facture via un prélèvement automatique ou un paiement manuel par le client.
- Mise en place d’une destination d’événement et écoute de l’événement
Le status
peut aussi passer à 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_
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_
ou error_
, 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 reste à 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 fixé, l’état de l’abonnement bascule sur incomplete_
et celui de la facture sur void
.
Ce délai a pour objet de permettre à votre client de réaliser le premier paiement de son abonnement en 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_
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_
.
Abonnements impayés
Pour les abonnements impayés, la dernière facture reste ouverte, mais aucune tentative de paiement n’est effectuée. L’abonnement continue de générer des factures à chaque cycle de facturation et reste à l’état draft
. Pour réactiver l’abonnement, vous devez :
- Collecter de nouvelles informations de paiement.
- Réactiver l’encaissement automatique en définissant auto advance sur
true
pour les brouillons de facture. - Finaliser les factures ouvertes et déclencher leur paiement. La facture la plus récente doit être réglée avant sa date d’échéance pour basculer l’état de l’abonnement sur
active
.
Le comportement par défaut définit les abonnements past_
sur unpaid
car ce réglage est celui qui vous offre le plus d’options pour les réactiver.
Annuler les 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_
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.
Annuler une facture générée par un abonnement
Si l’abonnement est à l’état incomplete
et que vous annulez la première facture générée, il bascule sur incomplete_
. Si vous annulez la facture la plus récente d’un abonnement actif et que celle-ci n’est pas la première, la logique suivante est appliquée à chaque facture (de la plus récente à la plus ancienne), jusqu’à ce qu’une des conditions soit remplie :
- Si la facture est à l’état
paid
ouuncollectible
, l’état de l’abonnement est défini suractive
. - Si l’attribut collection_method présente la valeur
charge_
permettant de débiter automatiquement sur facture et que les relances du paiement ont cessé après avoir atteint le nombre maximum de tentatives autorisées, l’abonnement passe à l’étatautomatically canceled
,unpaid
oupast_
, selon vos paramètres d’encaissement automatique.due - Si collection_method est défini sur
send_
et que la facture atteint sa date d’échéance, l’état de l’abonnement bascule surinvoice past_
.due - Si la facture ne se trouve dans aucun de ces états, les mêmes étapes sont exécutées sur la facture la plus récente suivante.
Si aucune facture ne remplit l’un ou l’autre des critères ci-dessus, l’état de l’abonnement est défini sur active
.
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.
Obtenir des informations de parrainage
Vous pouvez utiliser Stripe Apps pour les affiliations et les parrainages pour mettre en place et gérer des programmes de parrainage et d’affiliation avec Stripe, obtenir des informations sur les clients et automatiser les ajustements de commissions à partir du Dashboard Stripe.
États des abonnements
État | Description |
---|---|
trialing | L’abonnement est actuellement en période d’essai et vous pouvez fournir l’accès à votre produit sans risque. L’état de l’abonnement basculera sur active une fois le premier paiement effectué. |
active | L’abonnement est en règle et le paiement le plus récent a abouti. Vous pouvez fournir l’accès à votre produit sans risque. |
incomplete | Un paiement doit aboutir dans les 23 heures suivant la création de l’abonnement pour que ce dernier soit activé. Dans le cas contraire, une action est requise, comme une authentification du client. Les abonnements peuvent aussi être incomplete si un paiement est en attente et que l’état du PaymentIntent est processing . |
incomplete_ | Le paiement initial de l’abonnement a échoué et aucun paiement n’a abouti dans les 23 heures suivant la création de l’abonnement. Ces abonnements ne facturent pas les clients. Cet état vous permet d’assurer le suivi des clients qui ne sont pas parvenus à activer leur abonnement. |
past_ | Le paiement de la dernière facture finalisée a échoué ou n’a pas été tenté. L’abonnement continue de créer des factures. Vos paramètres d’abonnement déterminent l’état suivant de l’abonnement. Si la facture reste impayée après toutes les tentatives de relance Smart Retries, vous pouvez configurer l’abonnement pour qu’il bascule sur canceled , unpaid , ou le laisser sur past_ . Assurez-vous de payer la facture la plus récente avant sa date d’échéance pour faire basculer l’état de l’abonnement sur active . |
canceled | L’abonnement a été annulé. Lors de l’annulation, l’encaissement automatique de toutes les factures impayées est désactivé (auto_ ). Cet état est définitif et ne peut pas être mis à jour. |
unpaid | La dernière facture n’a pas été payée, mais l’abonnement reste valide. La dernière facture reste ouverte et des factures continuent à être générées, mais aucune tentative de paiement n’est effectuée. Vous devez révoquer l’accès à votre produit quand l’abonnement est unpaid puisque des tentatives de paiement ont déjà été effectuées et relancées lorsqu’il était à l’état past_ . Assurez-vous de payer la facture la plus récente avant sa date d’échéance pour faire basculer l’état de l’abonnement sur active . |
paused | The subscription has ended its trial period without a default payment method and the trial_settings.end_behavior.missing_payment_method is set to pause . Invoices will no longer be created for the subscription. After a default payment method has been attached to the customer, you can resume the subscription. |
É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 de destinations d’événements.
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.
Le tableau suivant décrit les événements les plus courants liés aux abonnements et, le cas échéant, suggère les actions à entreprendre pour les gérer.
customer. | Envoyé lorsqu’un objet Customer a bien été créé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer. | Envoyé 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_ sur default_ . Familiarisez-vous avec le comportement de paiement des abonnements pour en savoir plus. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer. | Envoyé lorsque l’abonnement d’un client prend fin. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer. | Envoyé 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. | Envoyé 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. | Envoyé 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. | Envoyé 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. | Envoyé 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. | Envoyé lorsqu’une facture est créée pour un nouvel abonnement ou un renouvellement. Si Stripe ne reçoit pas une réponse positive à invoice. , 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. | Envoyé lorsqu’une facture est finalisée et prête à être payée.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice. | La 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.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice. | Envoyé 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. | Envoyé lorsque la facture nécessite une authentification du client. Découvrez comment gérer un abonnement quand une action est requise pour la facture. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Le paiement d’une facture a échoué. L’état du PaymentIntent bascule sur
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice. | Envoyé 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. | Envoyé 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_ | Envoyé lorsqu’un PaymentIntent est créé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payment_ | Envoyé lorsqu’un PaymentIntent a effectué un paiement avec succès. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_ | Envoyé 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_ | Envoyé lorsqu’une planification d’abonnement est annulée, ce qui annule également tout abonnement actif associé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_ | Envoyé lorsque toutes les phases d’une planification d’abonnement sont terminées. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_ | Envoyé lorsqu’une nouvelle planification d’abonnement est créée. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_ | Envoyé 7 jours avant la date d’expiration d’un abonnement. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_ | Envoyé lorsqu’une planification d’abonnement est publiée, ou interrompue et dissociée de l’abonnement, lequel est conservé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_ | Envoyé lorsqu’une planification d’abonnement est mise à jour. |
Cycle de vie d’une facture
La page de présentation générale des factures fournit une explication plus détaillée du fonctionnement des factures, mais en ce qui concerne les factures générées par les abonnements, leur cycle de vie se déroule comme suit :
- L’abonnement génère une nouvelle facture à l’état
draft
. - Environ une heure après sa création, la facture est finalisée (les modifications ne sont plus autorisées).
- L’état est défini sur
open
et Stripe tente automatiquement d’effectuer le paiement avec le moyen par défaut. - Si le paiement aboutit, l’état bascule sur
paid
. - Si le paiement échoue, la facture reste
open
et l’abonnement bascule surpast_
.due
Dans ce flux, Stripe n’informe pas votre client de l’émission de la facture et le paiement est automatiquement tenté peu après sa génération. Cependant, si les e-mails client sont activés, nous envoyons un reçu par e-mail.
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 la création d’un abonnement, l’échec du paiement est l’événement le plus important qui puisse survenir. Plusieurs raisons peuvent être à l’origine d’un échec de paiement :
- Aucun moyen de paiement n’est associé au client.
- Le moyen de paiement a expiré.
- Le paiement est refusé.
Vous pouvez configurer Stripe de manière à ce qu’il relance les paiements qui ont échoué. La fonction Smart Retries utilise le machine learning de Stripe afin de déterminer le moment le plus opportun pour les relances, sur une période configurable allant jusqu’à 2 mois après l’échec du paiement initial.
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 :
Paramètre | Description |
---|---|
Annuler l’abonnement | L’abonnement passe à l’état canceled après le nombre maximum de jours défini dans le calendrier des relances. |
Marquer l’abonnement comme non payé | L’abonnement passe à l’état unpaid après le nombre maximum de jours défini dans le calendrier des relances. Les factures continuent à être générées et restent à l’état de brouillon. |
Laisser l’abonnement en retard de paiement | L’abonnement reste à l’état past_ après le nombre maximum de jours défini dans le calendrier des relances. Les factures continuent à être générées et le client est facturé en fonction des paramètres de relance. |
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 - 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_
d’un de vos clients arrive à expiration.source
Vous pouvez personnaliser votre URL pour mettre à jour une carte, ainsi que le logo et les couleurs utilisés dans vos e-mails, comme décrit dans la documentation relative aux reçus.
Paiement manuel
Vous pouvez configurer la date d’échéance des factures qui utilisent la méthode d’encaissement send_
pour recevoir des paiements manuels. Vous pouvez également configurer jusqu’à trois rappels, de 10 jours avant la date d’échéance jusqu’à 60 jours après.
Vous pouvez également déclencher des actions supplémentaires sur l’abonnement 30, 60 ou 90 jours après la date d’échéance de la facture. Vous pouvez :
Paramètre | Description |
---|---|
Annuler l’abonnement | L’abonnement passe à l’état canceled après le nombre maximum de jours défini dans le calendrier des relances. |
Marquer l’abonnement comme non payé | L’abonnement passe à l’état unpaid après le nombre maximal de jours défini dans le calendrier des relances. Les factures continuent à être générées et restent à l’état draft ou passent à l’état spécifié dans vos paramètres de facture. |
Laisser l’abonnement en retard de paiement | L’abonnement reste à l’état past_ après le nombre maximum de jours défini dans le calendrier des relances. Les factures continuent à être générées à l’état open . |
En savoir plus sur les états d’abonnement.
Paiements nécessitant 3D Secure
Pour les paiements qui nécessitent une vérification 3D Secure, Stripe peut envoyer un e-mail de confirmation à votre client en même temps que nous envoyons invoice.
. Vous pouvez également configurer l’envoi de trois rappels maximum, jusqu’à 7 jours après l’initiation du paiement.
Si le paiement n’est toujours pas finalisé au terme du nombre de jours défini, vous pouvez :
Paramètre | Description |
---|---|
Annuler l’abonnement | L’abonnement passe à l’état canceled après le nombre maximum de jours défini dans le calendrier des relances. |
Marquer l’abonnement comme non payé | L’abonnement passe à l’état unpaid après le nombre maximum de jours défini dans le calendrier des relances. Les factures continuent à être générées et restent à l’état de brouillon. |
Laisser l’abonnement en retard de paiement | L’abonnement reste à l’état past_ après le nombre maximum de jours défini dans le calendrier des relances. Les factures continuent à être générées et le client est facturé en fonction des paramètres de relance. |
Périodes d’essai
Les réseaux de cartes vous donnent l’obligation de fournir à vos clients certaines informations relatives à leurs périodes d’essai. Cette communication peut être gérée automatiquement par Stripe. Dans le Dashboard Stripe, vous pouvez configurer l’URL d’annulation à inclure dans les e-mails de rappel et sur le reçu de la première facture après la période d’essai. Vous pouvez aussi configurer le libellé de relevé bancaire pour le premier paiement après la période d’essai. Pour en savoir plus sur ces exigences et paramètres, consultez la page des périodes d’essai.
Modification des 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. Pour en savoir plus sur la modification des abonnements existants, consultez la page Modification des abonnements.