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 \
  -d ui_mode=custom \
  --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

Dans le front-end, recurring.trial contient les détails de la période d’essai de la session.

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 \
  -d ui_mode=custom \
  --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 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

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 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 le client vers le portail client, où il pourra ajouter ses informations de paiement à son abonnement.

Vos clients peuvent également reprendre leur abonnement suspendu sur le portail client en sélectionnant Démarrer l’abonnement, puis en ajoutant un moyen de paiement. Consultez la section consacrée aux périodes d’essai gratuit pour découvrir comment configurer un abonnement afin qu’il soit suspendu ou annulé lorsqu’un essai gratuit se termine sans moyen de paiement associé.

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.