Utiliser des périodes d'essai avec les abonnements

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 :

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d trial_end=1610403705

Le paramètre trial_end contient un horodatage indiquant l’heure exacte de fin de la période d’essai. 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.

Lors de la création d’un abonnement avec une période d’essai, aucun moyen de paiement n’est requis de la part du client. Une facture immédiate est tout de même créée, mais elle est de 0 $.

À 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 mettre à jour l’abonnement, en définissant la valeur trial_end sur un nouvel horodatage ou maintenant pour y mettre fin immédiatement :

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d trial_end=now

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.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d trial_end=1610403705 \
  -d billing_cycle_anchor=1611008505

Utiliser des périodes d’essai avec la facturation à la consommation

Vous pouvez utiliser des périodes d’essai pour les abonnements avec la facturation à la consommation. Pendant la période d’essai, l’utilisation n’est pas comptabilisée dans le total facturé au client à la fin du cycle de facturation. Après la fin de la période d’essai, l’utilisation est comptabilisée et facturée à la fin du cycle de facturation suivant.

Périodes d’essai et comptabilisation de l’utilisation

Si vous utilisez le paramètre aggregate_usage et que vous le définissez sur last_ever, votre client sera facturé pour le dernier enregistrement d’utilisation s’il tombe dans la période d’essai, même si l’utilisation s’est produite pendant la période d’essai.

Par exemple, si vous proposez une solution de stockage de fichiers, vous pouvez souhaiter offrir un mois de stockage, mais ensuite facturer le premier mois si le client continue de stocker des fichiers via votre service.

Facturation à la consommation avec les abonnements suspendus

Les abonnements comportant des postes d’abonnement avec facturation à la consommation à terme échu, car il est nécessaire de connaître l’utilisation totale pour déterminer le montant à facturer. Les abonnements suspendus ne permettent pas la création d’événements d’utilisation pour les postes d’abonnement associés. Dans la mesure où vous pouvez reprendre un abonnement au milieu d’une période de facturation sans modifier le début du cycle de facturation, nous prenons en charge la facturation des événements d’utilisation portant un horodatage postérieur à la reprise de l’abonnement.

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

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.

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.

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 carte. En savoir plus sur le respect des exigences relatives aux périodes d’essai et aux promotions.

Événements webhook

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 les événements de webhook relatifs aux abonnements.

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.

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 :

1. Écoutez l’événement customer.subscription.trial_will_end.
2. 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}}.
3. 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.
4. 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 aux paramètres 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 de fin de période d’essai en mode test. En savoir plus sur la façon de mettre en place les e-mails de fin de période d’essai.

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.

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