Utiliser des périodes d'essai avec les abonnements

Retardez les paiements d'abonnements actifs à l'aide de périodes d'essai.

Vous pouvez démarrer l’abonnement d’un client avec une période d’essai gratuite en donnant un argument trial_end lors de la création de l’abonnement :

Le paramètre trial_end comprend un horodatage indiquant le moment exact où la période d’essai s’arrête. Lors de la création d’un abonnement, vous pouvez également utiliser le paramètre trial_period_days, un nombre entier représentant la durée en nombre de jours de la période d’essai, à compter de l’instant présent. La période d’essai doit être de 730 jours (2 ans) maximum.

Lorsque vous créez un abonnement avec une période d’essai, vous n’avez pas besoin d’ajouter de moyen de paiement. Une facture immédiate est tout de même créée, mais le montant est égal à 0 et les descriptions des postes de facture incluent la mention « essai gratuit ».

À la fin de la période d’essai, si l’état status de l’abonnement n’est pas paused, nous générons une facture et envoyons une notification d’événement invoice.created. Environ une heure plus tard, nous tentons de débiter cette facture. Un nouveau cycle de facturation commence également pour le client à la fin de la période d’essai.

Pour mettre fin à une période d’essai de façon anticipée, exécutez un appel à l’API Update Subscription, en définissant la valeur trial_end sur un nouvel horodatage ou maintenant pour y mettre fin immédiatement :

Utiliser des périodes d’essai avec la date de début du cycle de facturation

Depuis la version de l’API 2018-02-05, vous pouvez également combiner les périodes d’essai avec billing_cycle_anchor, ce qui entraînera une période d’essai gratuite suivie d’une période au prorata et mènera à un cycle de facturation fixe.

Par exemple, supposons que nous sommes le 15 du mois et que vous souhaitez offrir à votre client une période d’essai gratuit de 7 jours (jusqu’au 22), puis débuter une facturation normale le 1er. Vous pouvez le faire via l’API en combinant les périodes d’essai avec billing_cycle_anchor. (Cette opération est actuellement indisponible via le Dashboard.)

Dans cet exemple, le client reçoit une facture pour un montant au prorata le 22 du mois (pour la période allant jusqu’au 1er). Ensuite, le 1er, il se verra facturer à nouveau pour le montant total, puis à nouveau le 1er du mois suivant, etc.

Facturation à la consommation avec les abonnements suspendus

Vous pouvez envoyer des événements de comptage associés à un prix sur un abonnement même lorsque celui-ci est en pause. Cependant, après la reprise de l’abonnement, la facture n’inclura pas les événements de compteur envoyés pendant la période de pause. Les factures ultérieures n’incluront que les événements de comptage survenus après la date de reprise de l’abonnement. Si vous utilisez d’anciens enregistrements d’utilisation, vous ne pouvez pas créer de nouveaux enregistrements d’utilisation lorsqu’un abonnement est en pause.

Ajout d’une période d’essai à la période d’essai précédente d’un abonnement

Vous pouvez ajouter une période d’essai à un abonnement non admissible en mettant à jour l’abonnement tout en précisant trial_end ou en actualisant la planification d’abonnement correspondante. Vous devez préciser phases.trial_end pour les abonnements.

Pour la plupart des abonnements qui entrent dans une nouvelle période d’essai après la fin d’une période d’essai précédente, le champ trial_start reste défini sur le début de la première période d’essai. Depuis l’API version du 30/04/2025, pour les abonnements dont billing_mode est défini sur flexible, trial_start reflète le début de la période d’essai la plus récente.

Utiliser des périodes d’essai avec add_invoice_items

Les périodes d’essai pour les abonnements peuvent être combinés avec des tarifs uniques et add_invoice_items. Cela peut se produire si vous souhaitez facturer des frais uniques ou les ajouter au moment même où débute une période d’essai. Veuillez noter que cela va immédiatement soustraire le montant du poste unique de la facture au début de l’essai.

Exigences de conformité pour les périodes d’essai et promotions

Vous devez répondre aux exigences des réseaux de cartes lorsque vous proposez des périodes d’essai, gratuites ou non. Cela comprend des scénarios tels que des essais gratuits ou l’application d’un tarif réduit les premiers mois avant la reprise de la facturation au tarif normal. Lors de l’utilisation de nos fonctionnalités d’essai, vous pouvez activer les paramètres de messages dans le Dashboard Stripe pour vous aider à répondre aux exigences.

Si vous informez les utilisateurs de la réussite d’un paiement, Stripe affiche automatiquement les informations relatives à la période d’essai et l’URL d’annulation dans ces notifications.

Si vous n’utilisez pas ces paramètres, vous êtes tout de même responsable de la conformité aux exigences.

Lorsque e-mails client sont activés, un rappel est envoyé sept jours avant la fin de la période d’essai. Si un essai est plus court que sept jours, l’e-mail de rappel est envoyé dès le début de l’essai. Si les essais sont renouvelés, un e-mail de rappel est à nouveau envoyé.

Si les rappels d’essai et les rappels de renouvellement d’abonnement sont activés pendant une période d’essai, les clients reçoivent uniquement le rappel de fin de période d’essai. Les e-mails de renouvellement sont envoyés pour les périodes de facturation suivantes.

Le lien vers les conditions d’annulation est un URL qui s’affiche sur les reçus du client avec d’autres informations relatives à l’essai. Ces informations sont comprises pour tous les paiements par carte. L’URL d’annulation est également compris dans l’e-mail de rappel qui est envoyé aux clients sept jours avant la fin de leur période d’essai.

Si vous définissez manuellement le libellé de relevé bancaire sur la facture, le texte correspondant à la période d’essai n’est pas associé automatiquement, vous devez donc l’ajouter manuellement. Si vous utilisez des libellés de relevé bancaire pour vos produits, le texte correspondant à la période d’essai est associé automatiquement. Si votre libellé de relevé bancaire contient plus de 10 caractères, assurez-vous qu’il soit toujours compréhensible par vos clients. La limite est fixée à 22 caractères, et tout ce qui est écrit au-delà de 10 caractères est écrasé par * TRIAL OVER.

Si vous ne définissez pas manuellement le libellé de relevé bancaire ou n’utilisez pas de libellés de relevé bancaire de produits, le texte de la période d’essai sera associé au libellé de relevé bancaire de votre compte. Le cas échéant, vous pouvez définir un libellé abrégé pour vous assurer que le texte de la période d’essai s’affiche correctement.

Respect des exigences sans utiliser les fonctionnalités de Stripe

Si vous proposez des promotions ou des périodes d’essai sans utiliser nos fonctionnalités d’essai, vous devez tout de même répondre aux exigences. Vous pouvez écouter l’événement invoice.upcoming pour déterminer quand envoyer des notifications par e-mail. Pour ajouter du texte à votre libellé de relevé bancaire qui indique la fin de la promotion :

Écoutez l’événement customer.subscription.updated
Vérifiez si une période d’essai ou une promotion a pris fin
Mettez à jour le libellé de relevé bancaire sur latest_invoice de l’abonnement

Vous devez mettre à jour la dernière facture dans l’heure suivant sa création, tant qu’elle est à l’état d’ébauche.

Créer des essais gratuits sans collecter de moyen de moyens de paiement

Conseil en matière de sécurité

En permettant à vos clients potentiels d’effectuer un essai gratuit sans moyen de paiement, vous leur donnez la possibilité de tester votre produit ou service plus rapidement, mais vous permettez également à des spammeurs de créer un grand nombre de faux clients, de fausses utilisations et de faux abonnements. Nous vous recommandons d’étudier attentivement le flux d’inscription des utilisateurs illustré ici afin de trouver le juste équilibre entre faciliter la vie des clients légitimes et rendre la tâche des robots spammeurs plus difficile (par exemple, en demandant aux clients de créer un compte d’utilisateur et de passer une vérification captcha avant de commencer leur essai gratuit).

Vous pouvez proposer à vos clients une période d’essai gratuite sans collecter leurs informations de paiement, à partir du Dashboard, de l’API ou de Checkout. À la création de l’abonnement, vous pouvez préciser si celui-ci doit être annulé ou suspendu à l’issue de la période d’essai, dans l’éventualité où le client ne fournirait pas de moyen de paiement d’ici là. Pour annuler ou suspendre l’abonnement, définissez le paramètre trial_settings.end_behavior.missing_payment_method à la création ou modification de l’abonnement :

Annuler l’abonnement : si la période d’essai gratuite se termine sans moyen de paiement, l’abonnement est immédiatement annulé. Si par la suite, le client décide de s’abonner à une offre payante, vous pourrez alors créer un nouvel abonnement. Définissez le paramètre missing_payment_method=cancel pour annuler l’abonnement à la fin de la période d’essai en l’absence de moyen de paiement disponible.
Suspendre l’abonnement : si la période d’essai gratuite se termine sans moyen de paiement, l’abonnement est suspendu, c’est-à-dire qu’il ne génère plus de factures (contrairement à ce qui se passe en cas de suspension de l’encaissement des paiements). Si votre client ajoute ensuite son moyen de paiement, vous pouvez reprendre l’abonnement. Un abonnement peut rester suspendu indéfiniment. Définissez le paramètre missing_payment_method=pause pour suspendre l’abonnement à la fin de la période d’essai en l’absence de moyen de paiement disponible.

Vous pouvez également définir le paramètre missing_payment_method=create_invoice pour facturer le client à la fin de la période d’essai en l’absence d’un moyen de paiement. Si aucun moyen de paiement n’est fourni lors de la finalisation de la facture, l’abonnement passe à l’état past_due.

Pour recueillir les informations de paiement du client, configurez des e-mails de relance dans les paramètres des messages relatifs aux essais gratuits.

Configurer l’annulation des essais gratuits en l’absence de moyen de paiement

Utilisez le Dashboard, l’API ou Checkout pour créer des abonnements avec période d’essai gratuite sans recueillir les informations de paiement de vos clients, de manière à ce que les abonnements soient annulés si aucun moyen de paiement n’est fourni au terme de la période d’essai.

Vous pouvez utiliser le Dashboard pour proposer à vos clients un essai gratuit pour un abonnement sans avoir à collecter leurs informations de paiement :

Depuis les paramètres des abonnements du Dashboard, sélectionnez +Créer un abonnement.
Après avoir ajouté votre client et vos informations produit, sélectionnez +Ajouter un essai gratuit et indiquez la durée (en jours) de cet essai.
Sélectionnez l’option Suspendre ou annuler si aucun moyen de paiement n’est enregistré au terme de la période d’essai gratuite, puis Annuler immédiatement. Si vous utilisez des horloges de simulation, faites avancer l’horloge jusqu’à la fin de la période d’essai. Vous ne verrez aucune facture à venir pour cet abonnement.
Écoutez l’événement customer.subscription.deleted, qui vous informe lorsqu’un abonnement est annulé à sa fin de la période d’essai en l’absence de moyen de paiement.

Si vous fournissez un moyen de paiement ou sélectionnez l’option Envoyer au client un e-mail contenant la facture et un lien vers la page de paiement, l’option Suspendre ou annuler si aucun moyen de paiement n’est enregistré au terme de la période d’essai gratuite n’apparaîtra pas.

Configurer la suspension des essais gratuits en l’absence de moyen de paiement

Utilisez le Dashboard, l’API ou Checkout pour créer des abonnements avec période d’essai gratuite sans recueillir les informations de paiement de vos clients, de manière à ce que les abonnements soient suspendus si aucun moyen de paiement n’est fourni au terme de la période d’essai.

Vous pouvez utiliser le Dashboard pour proposer à vos clients un essai gratuit pour un abonnement sans avoir à collecter leurs informations de paiement :

Depuis les paramètres des abonnements du Dashboard, sélectionnez +Créer un abonnement.
Après avoir ajouté votre client et vos informations produit, sélectionnez +Ajouter un essai gratuit et indiquez la durée (en jours) de cet essai.
Sélectionnez l’option Suspendre ou annuler si aucun moyen de paiement n’est enregistré au terme de la période d’essai gratuite, puis Suspendre. Si vous utilisez des horloges de simulation, faites avancer l’horloge jusqu’à la fin de la période d’essai. Vous ne verrez aucune facture à venir pour cet abonnement.
Écoutez l’événement customer.subscription.paused, qui vous informe lorsqu’un abonnement est suspendu à la fin de la période d’essai en l’absence de moyen de paiement.

Collecter les informations de paiement de votre client avant la fin de leur période d’essai

Configurez votre abonnement de sorte à envoyer automatiquement un e-mail de rappel lorsque la période d’essai du client est sur le point d’expirer. Lorsque vous offrez des périodes d’essai, vous devez vous conformer aux exigences du réseau de cartes. En savoir plus sur le respect des exigences relatives aux périodes d’essai et aux promotions.

Événements

Toute modification d’une période d’essai entraîne le déclenchement d’un événement. Veillez à ce que votre intégration gère les événements de manière adéquate. Vous pouvez par exemple envoyer un e-mail à vos clients avant la fin de leur période d’essai. En savoir plus sur la gestion des événements d’abonnement.

Le tableau suivant répertorie les événements déclenchés avant la fin d’une période d’essai, à la suspension ou l’annulation d’un abonnement en période d’essai, ou à la reprise et l’activation d’un abonnement.

Événement	Description	Cas d’usage
`customer.subscription.deleted`	Envoyé à la fin d’un abonnement.	Interrompez l’accès à votre produit en réponse à cet événement. L’abonnement passe à l’état `canceled` et envoie cet événement quand une période d’essai gratuit se termine sans moyen de paiement et que la valeur du comportement `missing_payment_method` de l’abonnement est `cancel`.
`customer.subscription.resumed`	Envoyé en cas de reprise d’un abonnement suspendu. Lorsque vous recevez cet événement, accordez au client l’accès au produit s’il a été révoqué en raison d’une suspension d’abonnement.	Les abonnements suspendus sont convertis en abonnements actifs dès leur reprise. La reprise d’un abonnement peut déclencher la génération d’une facture et la création d’un PaymentIntent correspondant, lequel doit être payé pour que l’abonnement puisse quitter l’état `paused`.
`customer.subscription.paused`	Envoyé en cas de suspension complète d’un abonnement. Aucune facture n’est émise tant que l’abonnement n’a pas repris. Lorsque vous recevez cet événement, vous pouvez révoquer l’accès du client au produit jusqu’à ce qu’il ajoute un moyen de paiement et que l’abonnement reprenne.	Interrompez l’accès à votre produit en réponse à cet événement. L’abonnement passe à l’état `paused` et envoie cet événement quand une période d’essai gratuit se termine sans moyen de paiement et que la valeur du comportement `missing_payment_method` de l’abonnement est `pause`. L’abonnement conserve l’état `paused` jusqu’à sa reprise explicite.
`customer.subscription.trial_will_end`	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é.	Configurez l’abonnement de manière à envoyer automatiquement un e-mail à votre client 3 jours avant la fin de la période d’essai.

Utiliser le portail client pour encaisser des paiements

Après avoir créé un abonnement pour un client sans collecter de moyen de paiement, vous pouvez le rediriger vers le portail client Billing afin d’ajouter ses informations de paiement.

Pour commencer, configurez le portail client Billing pour donner la possibilité à vos clients de gérer leurs abonnements.

Ensuite, collectez les informations de facturation de vos clients :

Écoutez l’événement customer.subscription.trial_will_end.
Si aucun moyen de paiement par défaut n’est défini pour l’abonnement, récupérez l’adresse e-mail du client à l’aide de l’API Customers et envoyez-lui un message contenant un lien vers votre site. Nous vous conseillons d’intégrer l’ID du client à l’e-mail. Par exemple : https://example.com?...&customer={{CUSTOMER_ID}}.
Lorsque le client accède à votre site, créez une session de portail client à l’aide de l’ID du client de l’étape précédente.
Redirigez votre client vers le portail client, où il pourra mettre à jour son abonnement avec ses informations de paiement.

Autoriser les clients à réactiver leurs abonnements dans le portail client

Pour activer l’abonnement d’un client dont l’essai s’est terminé par la suspension de l’abonnement (paused) via le portail client, activez l’essai gratuit sans fonctionnalité de moyen de paiement au moment de créer un nouvel abonnement dans le Dashboard.

Envoyer un e-mail de rappel avant la fin de leur période d’essai

Pour envoyer un e-mail de rappel avant la fin de la période d’essai, accédez au paramètre Abonnements et e-mails, puis sélectionnez l’option Lien vers une page hébergée par Stripe. L’e-mail de rappel contient un lien permettant au client d’ajouter ou de modifier ses informations de paiement. Nous n’envoyons pas d’e-mails de rappel pour les périodes d’essai gratuit dans un environnement de test. En savoir plus sur la configuration des rappels pour les périodes d’essai gratuit.

Utilisez l’événement customer.subscription.trial_will_end pour envoyer vos propres e-mails hébergés à vos clients. Une fois que vous pourrez voir l’événement dans le Dashboard, vous saurez que votre e-mail a bien été envoyé.

Convertissez un essai en abonnement si vos clients fournissent leurs informations de paiement avant la fin de l’essai

Les abonnements et les prochaines factures sont créées au début de l’essai et deviennent actives lorsque celui-ci s’achève si le client fournit un moyen de paiement.

Configurer la mise en suspens lorsque aucun moyen de paiement n’est fourni

Lorsqu’un essai gratuit s’achève, vous pouvez configurer la mise en suspens d’abonnements si aucun moyen de paiement par défaut n’est disponible pour un abonnement.

Les abonnements suspendus peuvent être modifiés. Les modifications qui font habituellement l’objet de calculs au prorata (ajouts de poste de facture, changement de tarif, d’offre ou de quantité, etc.) ne génèreront pas de postes de facture au prorata, car le client n’est pas facturé pendant la suspension de l’abonnement. Si vous souhaitez prolonger la période d’essai d’un abonnement qui est passé à l’état paused, vous devez reprendre l’abonnement avant de configurer une période d’essai.

Nous vérifions les paramètres default_source et default_payment_method de l’abonnement et du client pour déterminer s’il manque un moyen de paiement à un abonnement à la fin de la période d’essai.

Reprendre un abonnement suspendu

Utilisez le Dashboard, l’API, le portail client ou la page de facture hébergée pour reprendre un abonnement suspendu.

Pour réactiver un abonnement suspendu dans le Dashboard, accédez à l’abonnement, puis sélectionnez Reprendre l’abonnement depuis le menu Actions. Sélectionnez Réinitialiser le cycle de facturation ou Toujours facturer (si vous ne réinitialisez pas le cycle de facturation) dans la fenêtre modale Reprendre l’abonnement pour débiter le client immédiatement.

Facturation d’un abonnement

Lorsqu’un abonnement est suspendu, celui-ci n’entraîne aucune facturation. Si vous souhaitez continuer à générer des factures, utilisez pause_collection pour arrêter l’encaissement des paiements tout en garantissant la continuité des périodes de facturation.

Pour prévisualiser la facture générée lors de la reprise d’un abonnement suspendu, spécifiez subscription_details.resume_at.