Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
Aperçu
Billing
PrésentationÀ propos des API Billing
Abonnements
Tax
PrésentationTaux de taxe
Rapports
PrésentationRapports sur plusieurs comptes
Données
PrésentationData Pipeline nouvelle générationBase de données
Version bêta publique

Configurer des offres d'essai sur les abonnementsVersion bêta publique

Proposez des essais gratuits ou payants pour les éléments d'un abonnement.

Utilisez l’API Trial Offer pour gérer à la fois les périodes de lancement gratuites et payantes de vos abonnements avec une seule intégration API. Les offres d’essai vous permettent d’identifier les prospects les plus motivés, de limiter les abus et de proposer des tarifs réduits à vos clients pendant une durée limitée (par exemple, 1 EUR pour la première semaine d’une offre).

Cas d’usage

Avec les offres d’essai, vous pouvez exécuter des tests de tarification promotionnelle et d’offre de produits directement dans Stripe. Les cas d’usage courants pour les offres d’essai comprennent :

Cas d’usageDescription
Essais à prix réduitPour améliorer votre taux de conversion de la période d’essai à la période payante et générer des revenus, vous pouvez mettre en place des périodes d’essai à prix réduit. Par exemple, vous proposez un prix de lancement réduit de 4 EUR pendant 4 semaines ou proposez un essai gratuit de 7 jours.
Périodes d’essai gratuitePour proposer un abonnement d’essai gratuit, incluez un élément dans l’abonnement
Essais de mise à niveauPour vendre davantage de fonctionnalités premium, vous pouvez configurer des essais de mise à niveau. Par exemple, vous proposez à un client bénéficiant d’une offre de base une période d’essai de 7 jours pour accéder aux fonctionnalités premium au tarif de base. Ensuite, à la fin de la période d’essai, vous le convertissez automatiquement au tarif premium.
Essais au niveau des élémentsPour vendre des modules additionnels, des packs d’IA et d’autres offres groupées de fonctionnalités, vous pouvez configurer des périodes d’essai au niveau des éléments. Vous proposez aux clients une période d’essai pour un seul poste d’un abonnement tout en facturant d’autres postes à leur tarif normal.

Avant de commencer

Limitations

  • Les offres d’essai ne s’appliquent qu’aux éléments d’abonnement récurrents. Les éléments non récurrents ne sont pas admissibles aux essais payants ni aux essais à tarif réduit.
  • Vous pouvez utiliser le portail client pour consulter les offres d’essai, mais vous ne pouvez pas l’utiliser pour créer, gérer ou modifier des éléments d’offres d’essai en version bêta publique.
  • Vous ne pouvez pas modifier la durée de la période d’essai après avoir créé l’abonnement ou planifié des extensions et des réductions de période d’essai.
  • Les revenus des offres d’essai ne sont pas disponibles dans Billing Analytics. Stripe suit les revenus d’essai avec l’état trialing, mais les essais payants utilisent l’état active, ce qui signifie que Stripe considère les revenus d’essai comme des revenus d’abonnement ordinaires.
  • Les offres d’essai ne sont pas prises en charge par les calendriers d’abonnement dans le Dashboard. Vous ne pouvez gérer les calendriers d’abonnement avec des offres d’essai qu’à l’aide de l’API.
  • Limites de l’API Trial Offer et trial_end :
    • Vous ne pouvez pas utiliser simultanément les offres d’essai et l’ancien paramètre trial_end. Nous vous recommandons d’utiliser l’API* Trial Offer pour configurer les essais à prix réduit et les essais gratuits.
    • Si vous utilisez Checkout, vous ne pouvez pas utiliser d’offres d’essai. Pour créer des abonnements avec Checkout, vous devez utiliser les anciennes périodes d’essai gratuites avec trial_end. Consultez Configurer des périodes d’essai.

Fonctionnement des offres d’essai

Les produits décrivent les biens ou services spécifiques que vous proposez à vos clients et les tarifs définissent le coût unitaire. Un abonnement facture ces produits à un client au prix spécifié, de manière récurrente. Lorsque vous créez une offre d’essai pour un abonnement, vous indiquez un prix d’essai et la durée de l’essai pour un produit. À la fin de l’essai, l’abonnement revient automatiquement au prix normal ou à un autre prix.

Les offres d’essai ne remplacent pas les produits ou tarifs. Le Trial Offer est un objet distinct qui associe un tarif réduit ou gratuit à un élément Abonnement pour une durée limitée, sans modifier le tarif sous-jacent de l’élément.

Créer une offre d’essai

Pour créer une offre d’essai dans le Dashboard :

  1. Accédez à la page Produits.
  2. Cliquez sur un produit pour ouvrir la page de détails du produit.
  3. Dans la section Essais, cliquez sur le symbole plus ().
  4. Renseignez la boîte de dialogue Créer un essai avec le prix, la durée et le comportement de fin de l’essai.
  5. Cliquez sur Créer.

Vous pouvez également créer une offre d’essai depuis l’éditeur d’abonnement :

  1. Accédez à la page Abonnements.
  2. Cliquez sur + Créer un abonnement, ou cliquez sur un abonnement existant et sélectionnez Actions > Mettre à jour l’abonnement.
  3. Cliquez sur Ajouter un essai.
  4. Dans la boîte de dialogue, sélectionnez + Essai pour créer une nouvelle offre d’essai.
  5. Ajoutez les détails de l’essai, notamment le prix, la durée et le comportement de fin de l’essai.
  6. Cliquez sur Créer.

Associez une offre d’essai à un nouvel abonnement

Pour associer une offre d’essai à un nouvel abonnement dans le Dashboard :

  1. Accédez à la page Abonnements.
  2. Cliquez sur + Créer un abonnement.
  3. Cliquez sur Ajouter un essai.
  4. Dans la boîte de dialogue, sélectionnez une offre d’essai existante, ou sélectionnez + Essai pour créer une nouvelle offre d’essai à ajouter à l’abonnement.

Mettez à jour les abonnements avec une offre d’essai

Ajoutez une offre d’essai à un abonnement existant

Pour ajouter une offre d’essai à un abonnement existant dans le Dashboard :

  1. Accédez à la page Abonnements.
  2. Cliquez sur l’abonnement que vous souhaitez mettre à jour, puis sélectionnez Actions > Mettre à jour l’abonnement.
  3. Cliquez sur Ajouter un essai.
  4. Dans la boîte de dialogue, sélectionnez une offre d’essai existante, ou sélectionnez + Essai pour créer une nouvelle offre d’essai à ajouter à l’abonnement.

Ajoutez une offre d’essai à un abonnement avec des éléments existants

Pour ajouter une offre d’essai en tant que nouvel élément à un abonnement comportant déjà des éléments dans le Dashboard :

  1. Accédez à la page Abonnements.
  2. Cliquez sur l’abonnement que vous souhaitez mettre à jour, puis sélectionnez Actions > Mettre à jour l’abonnement.
  3. Cliquez sur Ajouter un essai.
  4. Dans la boîte de dialogue, sélectionnez une offre d’essai existante, ou sélectionnez + Essai pour créer une nouvelle offre d’essai à ajouter à l’abonnement.

Convertissez un élément abonnement en offre d’essai

Pour convertir un élément d’abonnement existant en offre d’essai, incluez le items.id et spécifiez le trial_offer.id dans le paramètre items.current_trial.trial_offer :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}}
 \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "items[0][id]=
{{SUBSCRIPTION_ITEM_ID}}
" \
  -d "items[0][current_trial][trial_offer]=to_123"

Modifiez la quantité d’éléments pour une offre d’essai

Pour modifier la quantité d’éléments d’une offre d’essai dans le Dashboard :

  1. Accédez à la page Abonnements.
  2. Cliquez sur l’abonnement que vous souhaitez mettre à jour, puis sélectionnez Actions > Mettre à jour l’abonnement.
  3. Modifiez le champ de quantité après avoir ajouté l’élément de l’offre d’essai.
  4. Cliquez sur Mettre à jour l’abonnement.

Ajoutez une offre d’essai à une planification d’abonnement

Vous ne pouvez utiliser des offres d’essai d’horodatage qu’avec des planifications d’abonnement. Contrairement aux essais à durée relative, qui se terminent après un nombre défini d’intervalles de facturation, les essais d’horodatage se terminent à une date absolue. Pour en créer un, définissez le duration.type de l’offre d’essai sur timestamp :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/product_catalog/trial_offers \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "price=
{{PRICE_ID}}
" \
  -d "duration[type]=timestamp" \
  -d "end_behavior[transition][price]=
{{PRICE_ID}}
"

Ensuite, utilisez phases.items.trial_offer pour associer l’offre d’essai à la phase calendrier de la planification d’abonnement :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer_account=
{{CUSTOMER_ACCOUNT_ID}}
" \
  -d start_date=1610403705 \
  -d "phases[0][items][0][trial_offer]=to_123" \
  -d "phases[0][end_date]=1610403706"

Afficher les abonnements avec périodes d’essai

Lorsque vous récupérez un abonnement, la réponse inclut la configuration de chaque élément, y compris les périodes d’essai :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}}
 \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2026-03-25.preview"

Annuler un abonnement à la fin d’une période d’essai payante

Pour annuler l’abonnement à la fin de l’essai payant :

  1. Créez un abonnement avec une offre d’essai.
  2. Définissez la date d’annulation à la fin de la période d’essai.

Ce flux prend en charge les renouvellements avec option d’adhésion, de sorte que les clients ne sont pas convertis en un abonnement récurrent par défaut.

Pour annuler un abonnement à la fin d’un essai payant dans le Dashboard :

  1. Sur la page Abonnements, recherchez l’abonnement concerné, cliquez sur le menu de débordement () et sélectionnez Annuler l’abonnement.
  2. Sélectionnez À une date personnalisée et définissez la date de fin de l’essai et de l’abonnement.
  3. Cliquez sur Annuler l’abonnement.

Pour plus d’informations, consultez la section Annuler des abonnements.

Utiliser les offres d’essai avec d’autres fonctionnalités

Les offres d’essai avec la facturation à l’usage

Lors de la création d’un objet Price, vous pouvez spécifier un tarif à la consommation au lieu d’un tarif récurrent et l’associer à une offre d’essai. Cela vous permet d’offrir les mêmes fonctionnalités de facturation à l’usage à un tarif réduit.

Pour utiliser un tarif à la consommation, définissez le paramètre utilisation_type sur metered et ajoutez un dispositif de mesure existant pour suivre l’utilisation.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d currency=usd \
  -d billing_scheme=per_unit \
  -d unit_amount=1 \
  -d "recurring[interval]=week" \
  -d "recurring[usage_type]=metered" \
  -d "recurring[meter]=mtr_123" \
  -d "product_data[name]=Trial Period Price"

Ensuite, associez le tarif à une offre d’essai comme vous le feriez pour tout autre tarif récurrent :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/product_catalog/trial_offers \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "price=
{{PRICE_ID}}
" \
  -d "duration[relative][iterations]=1" \
  -d "duration[type]=timestamp" \
  -d "end_behavior[transition][price]=
{{PRICE_ID}}
"

Considérations supplémentaires

État « trialing »et offre d’essai de l’abonnement

Lors de l’utilisation d’offres, le status d’un abonnement est déterminé par le prix de l’essai :

  • Essais gratuits () : si un abonnement contient uniquement des offres d’essai, et que tous les prix des offres d’essai sont définis sur , l’état de l’abonnement est trialing. Cela correspond à l’ancien comportement trial_end et est idéal pour les flux d’essai gratuit « sans carte bancaire requise » ou Standard.
  • Essais payants (>) : si l’abonnement comporte un élément tarifaire normal, ou si les offres d’essai ont un tarif non nul, l’état de l’abonnement sera active, incomplete ou past_due. Ce comportement imite d’autres abonnements sans offres d’essai. Étant donné qu’un essai payant nécessite un paiement immédiat réussi pour commencer, l’abonnement suit le cycle de vie Standard PaymentIntent. Cela garantit que votre logique de facturation existante, telle que les webhooks pour les paiements réussis, reste cohérente, que le client paie un prix promotionnel ou le montant récurrent complet.

Événements

Chaque fois qu’une période d’essai change, elle déclenche des événements. Assurez-vous que votre intégration les gère. Par exemple, vous pouvez envoyer un e-mail à un client avant la fin d’une période d’essai. En savoir plus sur la gestion des événements 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énementDescriptionCas d’usage
customer.subscription.deletedEnvoyé à 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.resumedEnvoyez 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 Payment Intent correspondant, lequel doit être payé pour que l’abonnement puisse quitter l’état paused.
customer.subscription.pausedEnvoyé 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_endEnvoyé 3 jours avant la fin de la période d’essai. Si la période d’essai est inférieure à 3 jours, l’événement est déclenché immédiatement.Configurez l’abonnement de manière à envoyer automatiquement un e-mail à votre client 3 jours avant la fin de la période d’essai.

Définir une date de début de facturation à la fin d’une offre d’essai

Lorsqu’une offre d’essai se termine et passe au tarif récurrent régulier, les clients doivent commencer immédiatement un nouveau cycle de facturation. Par défaut, la facturation billing_cycle_anchor de l’abonnement se réinitialise automatiquement à la fin de la période d’essai (maintenant). Cela garantit que vos clients sont facturés immédiatement du montant total pour leur premier intervalle régulier, sans générer de prorata.

Si vous ne souhaitez pas que votre billing_cycle_anchor soit modifié, vous pouvez le définir sur unchanged.

Les options de configuration de billing_cycle_anchor comprennent :

  • now (par défaut) : réinitialise le billing_cycle_anchor de l’abonnement à la date exacte de fin de l’offre d’essai. Cela crée un nouveau cycle de facturation pour le tarif normal et génère une facture d’un montant total sans prorata.
  • unchanged : conserve la date de début initiale de la création de l’abonnement. La période comprise entre la fin de la période d’essai et la date de début naturelle suivante est facturée au prorata.

Par exemple, si vous proposez une période d’essai de 7 jours pour et souhaitez que le premier débité mensuel de couvre un mois complet à partir du 8 e jour :

  1. 1 er janvier : abonnement créé avec une offre d’essai de 7 jours.
  2. 8 janvier : fin de la période d’essai. Le billing_cycle_anchor est automatiquement réinitialisé au 8 janvier.
  3. facture : Stripe génère une facture pour l’intégralité du tarif récurrent pour la période du 8 janvier au 8 février. Aucun calcul au prorata n’est appliqué.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer_account=
{{CUSTOMER_ACCOUNT_ID}}
" \
  -d "items[0][price]=
{{PRICE_ID}}
" \
  -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \
  -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged"

Voir aussi

Sur cette page