無料トライアルを設定

以下のいずれかのパラメーターを渡すことで、顧客のサブスクリプションを無料トライアルで開始するように Checkout Session を設定できます。

• subscription_data.trial_period_days、無料トライアルの期間 (日数)。
• subscription_data.trial_end、トライアル期間の終了を表す Unix タイムスタンプ。

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

決済手段を収集しない無料トライアル

デフォルトでは、Checkout Sessions はトライアル終了後に使用する決済手段を収集します。payment_method_collection=if_required を渡すことで、支払いの詳細を収集することなく、顧客を無料トライアルに登録できます。

trial_settings.end_behavior.missing_payment_method を過ぎてトライアルが終了する前に顧客が決済手段指定しなかった場合に、サブスクリプションをキャンセルするか一時停止するかを選択します。

• サブスクリプションのキャンセル- 無料トライアルのサブスクリプションが決済手段なしで終了した場合、すぐにキャンセルされます。顧客が将来有料プランに加入することを決定した場合、別のサブスクリプションを作成できます。
• サブスクリプションの一時停止- 無料トライアルのサブスクリプションが支払い方法を指定せずに終了した場合、サブスクリプションは一時停止され、再開されるまで循環しません。サブスクリプションを一時停止しても、請求書は生成されません (サブスクリプションの支払い回収が一時停止されている場合とは異なります)。サブスクリプションの一時停止後に顧客が支払い方法を追加した場合は、同じサブスクリプションを再開できます。サブスクリプションは無期限に一時停止したままにすることができます。

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

支払いの詳細を自動的に収集する

トライアルの有効期限が切れる前に、顧客から支払いの詳細を収集します。

サブスクリプションとメール通知の設定の無料トライアルに関するメッセージを管理するで、顧客のトライアルの有効期限が近づいている場合にリマインドメールを自動送信するように選択できます。

次に、Stripe がオンラインで提供するページへのリンク オプションを選択して、顧客が支払いの詳細を追加または更新するためのリンクを、リマインドメールに含めるようにします。サンドボックスでは無料トライアルのリマインダーメールは送信されません。詳しくは、無料トライアルのリマインダーを設定する方法をご覧ください。

トライアルを提供する際は、カードネットワークの要件に準拠する必要があります。詳しくはトライアルとプロモーションの法令遵守要件をご覧ください。

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.

トライアルを従量課金と組み合わせる

サブスクリプションのトライアル期間中に、従量課金ベースで請求できます。トライアル期間中に発生した使用量は、通常の請求サイクルの総額には含められません。トライアル期間の終了後に使用量が発生し、それが次回の請求サイクルの終了時に請求されます。

トライアルと使用量の集計

aggregate_usage パラメーターを使用し、動作を last_ever に設定した場合、最後の使用記録がトライアル期間内であれば、トライアル期間中に使用された場合であっても、その記録は顧客に対して請求されます。

たとえば、1 カ月の無料期間を設けてファイルストレージを提供する場合、その後顧客がサービスを使用してファイルの保存を継続すると、最初の月に対して顧客に請求します。