Configurer des essais gratuits

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, la durée (en jours) de votre essai gratuit.
• subscription_data.trial_end, un horodatage Unix représentant la fin de la période d’essai.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -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.

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.

• 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. Si votre client ajoute ensuite son moyen de paiement, vous pouvez reprendre l’abonnement. Un abonnement peut rester suspendu indéfiniment.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -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 automatique des informations de paiement

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

Sélectionnez ensuite 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 concernant les périodes d’essai dans les environnements de test. En savoir plus sur la configuration des rappels de fin de période d’essai.

Lorsque vous proposez 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.

Collecter des données de paiement avec le portail client Billing

You can also send the reminder email yourself, and redirect customers to the Billing customer portal to add their payment details.

First, configure the Billing customer portal to enable your customers to manage their subscriptions.

Next, collect billing information from your customers:

1. Listen to the customer.subscription.trial_will_end event.
2. If the subscription doesn’t have a default payment method, get the customer’s email using the Customers API and send them a message with a link to your site. It’s helpful to embed the customer ID in the email, for example https://example.com?...&customer={{CUSTOMER_ID}}.
3. When the customer lands on your site, create a customer portal session using the customer ID from the previous step.
4. Redirect the customer to the customer portal, where they can update their subscription with payment details.

Your customers can also resume their paused subscription in the customer portal by selecting Start subscription, then adding a payment method. View free trial periods to learn how to configure a subscription to pause or cancel when a free trial ends without a payment method attached.

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

Vous pouvez utiliser des périodes d’essai pour les abonnements avec la facturation à l’usage. 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.