無料トライアルを設定

以下のいずれかのパラメーターを渡すことで、顧客のサブスクリプションを無料トライアルで開始するように 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 \
  -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

フロントエンドの recurring.trial には、セッションのトライアル期間の詳細が含まれています。

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

デフォルトでは、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 \
  -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

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

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

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

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

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

Billing カスタマーポータルで支払いの詳細を収集する

お客様自らリマインダーを送信して、顧客を Billing カスタマーポータルにリダイレクトし、支払い情報を追加させることも可能です。

まず、Billing カスタマーポータルを設定して、顧客がサブスクリプションを自ら管理できるようにします。

次に、顧客から請求先情報を収集します。

1. customer.subscription.trial_will_end イベントをリッスンします。
2. サブスクリプションに default payment method (デフォルトの決済手段) がない場合、Customer API を使用して顧客のメールアドレスを取得し、お客様のサイトへのリンクが記載されたメッセージを送信するようにしてください。メールに顧客 ID を埋め込んでおくと便利です (例: https://example.com?...&customer={{CUSTOMER_ID}})。
3. 顧客がサイトにアクセスしたら、前のステップの顧客 ID を使用してカスタマーポータルセッションを作成します。
4. 顧客をカスタマーポータルにリダイレクトします。ここで顧客は、支払い情報を使用してサブスクリプションを更新できます。

顧客は、一時停止中のサブスクリプションを再開することもできます。カスタマーポータルでサブスクリプションを開始を選択した後、決済手段を追加することで操作は完了します。無料トライアルが終了したときに、決済手段を関連付けることなくサブスクリプションを一時停止またはキャンセルするように設定する方法については、無料トライアル期間の記事を参照してください。

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

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