請求サイクル日の設定

You can explicitly set a subscription’s billing cycle anchor to a fixed date (for example, the 1st of the next month) when creating a Checkout Session. The billing cycle anchor determines the first full invoice date, when customers are billed the full subscription amount. The billing cycle anchor and the recurring interval of its price also determine a subscription’s future billing dates. For example, a monthly subscription created on May 15 with an anchor at June 1 is billed on May 15, then always on the 1st of the month.

For the initial billing period up until the first full invoice date, you can customize how to handle prorations with the proration_behavior parameter. By default, proration_behavior is set to create_prorations, and customers receive a prorated invoice. If proration_behavior is none, customers receive the initial period up to the first full invoice date for free.

請求サイクルアンカーを指定して Checkout セッションを作成する

To configure a billing cycle anchor, set the subscription_data.billing_cycle_anchor parameter when you create a Checkout Session in subscription mode. The anchor must be a future UNIX timestamp before the next natural subscription billing date.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]"=1611008505

請求サイクルアンカーがセッションの有効な期間内であり、顧客がその期間を過ぎてから支払おうとした場合、Checkout は、請求サイクルアンカーまでの比例配分が適用された期間ではなく、請求サイクルアンカーから始まる期間全体を表示して請求します。

比例配分の無効化

To disable prorations, set the subscription_data.proration_behavior parameter to none when creating a Checkout Session.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]"=1611008505 \
  -d "subscription_data[proration_behavior]"=none

無料トライアルと同様に、請求サイクルの起点までの最初の期間は無料です。トライアルと異なる点は、0 USD の請求書が生成されないことです。顧客は、請求サイクルの起点の日付にサブスクリプションの全額の請求書を受け取ります。

比例配分を無効にすると、Checkout セッションの応答オブジェクトで、line items と total details に関連付けられている金額が常に 0 になります。また、決済が将来の日付に先送りされることを反映してセッションの payment status が no_payment_required に設定されます。