Configure a free trial without collecting payment details

Beta

Create a Checkout Session with the following:

• A subscription_data dictionary with a trial_period_days field set to the length (in days) you want your free trial to be. In this example, the trial period is 30 days.
• The payment_method_collection field with a value of if_required. This tells Stripe that collecting payment information at checkout is optional.
  curl

  Stripe CLI

  Ruby

  Python

  PHP

  Java

  Node

  Go

  .NET

  curl https://api.stripe.com/v1/checkout/sessions \
    -u 
  sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
    -d mode=subscription \
    -d "line_items[0][price]"="{{PRICE_ID}}" \
    -d "line_items[0][quantity]"=1 \
    -d "subscription_data[trial_period_days]"=30 \
    -d payment_method_collection=if_required
  

Before the trial expires, collect payment details from your customer.

Configure your subscription to automatically send a reminder email when the customer’s trial is about to expire. You must comply with card network requires when offering trials. Learn more about compliance requirements for trials and promotion.

Next, select the Link to a Stripe-hosted page option so the reminder email contains a link for the customer to add or update their payment details. We don’t send free trial reminder emails in test mode. Learn more about how to manage free trial messages within the customer email.