# Configurer des essais gratuits Retarder les paiements d'abonnements à l'aide de périodes d'essai gratuit Vous pouvez configurer des essais gratuits avec Stripe Checkout. La durée maximale d’un essai gratuit est de 2 ans (730 jours), mais la plupart des entreprises utilisent des essais plus courts, comme 30 jours. Voici quelques problèmes qui peuvent affecter les essais plus longs : - Moyens de paiement expirant avant le premier paiement - Taux de conversion plus faibles # Page hébergée > This is a Page hébergée for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/free-trials?payment-ui=stripe-hosted. Vous pouvez configurer une session Checkout pour démarrer l’abonnement d’un client par un essai gratuit en transmettant l’un des paramètres suivants : - [subscription_data.trial_period_days](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_period_days), la durée (en jours) de votre période d’essai. - [subscription_data.trial_end](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_end), un timestamp Unix représentant la fin de la période d’essai. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" ``` ## Périodes d’essai gratuites sans enregistrement d’un moyen de paiement Par défaut, les sessions Checkout collectent un moyen de paiement à utiliser à la fin de la période d’essai. Vous pouvez inscrire vos clients à des essais gratuits sans collecter leurs informations de paiement en transmettant [payment_method_collection=if_required](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_collection). Choisissez d’annuler ou de suspendre l’abonnement si le client ne fournit pas de moyen de paiement avant la fin de la période d’essai en transmettant [trial_settings.end_behavior.missing_payment_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_settings-end_behavior-missing_payment_method). - **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. - **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](https://docs.stripe.com/billing/subscriptions/pause-payment.md). Si votre client ajoute ensuite son moyen de paiement, vous pouvez reprendre l’abonnement. Un abonnement peut rester suspendu indéfiniment. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" \ -d "subscription_data[trial_settings][end_behavior][missing_payment_method]=cancel" \ -d payment_method_collection=if_required ``` ### Collecter les informations de paiement automatiquement Avant l’expiration de l’essai, collectez les informations de paiement de votre client. Sous **Gérer les messages relatifs aux essais gratuits** dans vos [paramètres d’abonnements et d’e-mails](https://dashboard.stripe.com/settings/billing/automatic), vous pouvez choisir d’envoyer automatiquement un e-mail de rappel à votre client lorsque sa période d’essai est sur le point d’expirer. Ensuite, sélectionnez l’option **Lien vers une page hébergée par Stripe** afin d’intégrer à l’e-mail de rappel 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 [mise en place des rappels de fin de période d’essai](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#trial-ending-reminders). Lorsque vous proposez des périodes d’essai, vous devez vous conformer aux exigences du réseau de cartes bancaires. En savoir plus sur [les exigences de conformité relatives aux périodes d’essai et aux promotions](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). ### Collecter des données de paiement avec le portail client Billing Vous pouvez également envoyer vos propres e-mails de rappel et rediriger les clients vers le portail client Billing, sur lequel ils pourront saisir leurs données de paiement. Pour commencer, configurez le [portail client Billing](https://docs.stripe.com/customer-management.md) 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](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.trial_will_end) `customer.subscription.trial_will_end`. 1. Si l’abonnement n’a pas de [moyen de paiement par défaut](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method), récupérez l’adresse e-mail du client dans l’objet [Account](https://docs.stripe.com/api/v2/core/accounts/retrieve.md) ou [Customer](https://docs.stripe.com/api/customers/retrieve.md) configuré par le client associé. Envoyez au client un message contenant un lien vers votre site. Intégrez l’identifiant du client dans l’e-mail, par exemple **https://example.com?..&customer={{CUSTOMER\_ID}}**. 1. 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. 1. [Redirigez](https://docs.stripe.com/customer-management/integrate-customer-portal.md#redirect)-le vers le portail client, où il pourra mettre à jour son abonnement avec ses informations de paiement. Vos clients peuvent également [reprendre leur abonnement en suspend](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#resume-a-paused-subscription) dans le portail client en sélectionnant **Démarrer abonnement**, puis en ajoutant un moyen de paiement. Affichez les [périodes d’essai gratuit](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment) pour savoir comment configurer un abonnement pour qu’il soit suspendu ou annulé lorsqu’un essai gratuit se termine sans moyen de paiement associé. # Page intégrée > This is a Page intégrée for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/free-trials?payment-ui=embedded-form. Vous pouvez configurer une session Checkout pour démarrer l’abonnement d’un client par un essai gratuit en transmettant l’un des paramètres suivants : - [subscription_data.trial_period_days](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_period_days), la durée (en jours) de votre période d’essai. - [subscription_data.trial_end](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_end), un timestamp Unix représentant la fin de la période d’essai. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" ``` ## Périodes d’essai gratuites sans enregistrement d’un moyen de paiement Par défaut, les sessions Checkout collectent un moyen de paiement à utiliser à la fin de la période d’essai. Vous pouvez inscrire vos clients à des essais gratuits sans collecter leurs informations de paiement en transmettant [payment_method_collection=if_required](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_collection). Choisissez d’annuler ou de suspendre l’abonnement si le client ne fournit pas de moyen de paiement avant la fin de la période d’essai en transmettant [trial_settings.end_behavior.missing_payment_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_settings-end_behavior-missing_payment_method). - **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. - **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](https://docs.stripe.com/billing/subscriptions/pause-payment.md). Si votre client ajoute ensuite son moyen de paiement, vous pouvez reprendre l’abonnement. Un abonnement peut rester suspendu indéfiniment. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" \ -d "subscription_data[trial_settings][end_behavior][missing_payment_method]=cancel" \ -d payment_method_collection=if_required ``` ### Collecter les informations de paiement automatiquement Avant l’expiration de l’essai, collectez les informations de paiement de votre client. Sous **Gérer les messages relatifs aux essais gratuits** dans vos [paramètres d’abonnements et d’e-mails](https://dashboard.stripe.com/settings/billing/automatic), vous pouvez choisir d’envoyer automatiquement un e-mail de rappel à votre client lorsque sa période d’essai est sur le point d’expirer. Ensuite, sélectionnez l’option **Lien vers une page hébergée par Stripe** afin d’intégrer à l’e-mail de rappel 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 [mise en place des rappels de fin de période d’essai](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#trial-ending-reminders). Lorsque vous proposez des périodes d’essai, vous devez vous conformer aux exigences du réseau de cartes bancaires. En savoir plus sur [les exigences de conformité relatives aux périodes d’essai et aux promotions](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). ### Collecter des données de paiement avec le portail client Billing Vous pouvez également envoyer vos propres e-mails de rappel et rediriger les clients vers le portail client Billing, sur lequel ils pourront saisir leurs données de paiement. Pour commencer, configurez le [portail client Billing](https://docs.stripe.com/customer-management.md) 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](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.trial_will_end) `customer.subscription.trial_will_end`. 1. Si l’abonnement n’a pas de [moyen de paiement par défaut](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method), récupérez l’adresse e-mail du client dans l’objet [Account](https://docs.stripe.com/api/v2/core/accounts/retrieve.md) ou [Customer](https://docs.stripe.com/api/customers/retrieve.md) configuré par le client associé. Envoyez au client un message contenant un lien vers votre site. Intégrez l’identifiant du client dans l’e-mail, par exemple **https://example.com?..&customer={{CUSTOMER\_ID}}**. 1. 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. 1. [Redirigez](https://docs.stripe.com/customer-management/integrate-customer-portal.md#redirect)-le vers le portail client, où il pourra mettre à jour son abonnement avec ses informations de paiement. Vos clients peuvent également [reprendre leur abonnement en suspend](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#resume-a-paused-subscription) dans le portail client en sélectionnant **Démarrer abonnement**, puis en ajoutant un moyen de paiement. Affichez les [périodes d’essai gratuit](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment) pour savoir comment configurer un abonnement pour qu’il soit suspendu ou annulé lorsqu’un essai gratuit se termine sans moyen de paiement associé. ## See also - [Utilisation des périodes d’essai avec les abonnements](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md) - [Envoie d’un e-mail de rappel avant la fin de la période d’essai](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md#notify-customers-with-trial-end-reminder-emails) - [Association des périodes d’essai à la facturation à l’usage](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#trials-usage-based-billing)