# 請求サイクル日の設定

サブスクリプションの請求サイクルの起点を一定の日付に設定します。

# ホスト型ページ

> This is a ホスト型ページ for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/billing-cycle?payment-ui=stripe-hosted.

Checkout セッションの作成時に、サブスクリプションの[請求サイクルの起点](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-billing_cycle_anchor)を固定の日付 (翌月の第 1 日など) に明示的に設定できます。請求サイクルの起点によって、最初の満額請求日 (顧客にサブスクリプションの全額を請求する日) が決まります。また、請求サイクルの起点と、その[料金](https://docs.stripe.com/products-prices/overview.md)の繰り返し間隔によって、サブスクリプションの将来の請求日も決まります。たとえば、月次サブスクリプションが 5 月 15 日に作成され、その起点が 6 月 1 日に設定されている場合、請求は 5 月 15 日に行われ、その後は常に毎月 1 日に請求されます。

最初の請求期間から最初の満額請求日までは、[proration_behavior](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-proration_behavior) パラメーターを使用して [比例配分](https://docs.stripe.com/billing/subscriptions/prorations.md)の処理方法をカスタマイズできます。デフォルトでは、`proration_behavior` は `create_prorations` に設定されており、顧客は比例配分された*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)を受け取ります。`proration_behavior` が `none` の場合、顧客は最初の期間を、最初の満額請求日までは無料で利用できます。

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

請求書サイクルのアンカーを設定するには、`subscription` モードで checkout セッションを作成するときに `subscription_data.billing_cycle_anchor` パラメーターを設定します。このアンカーは、次回の定期決済の請求日より前の将来の unix タイムスタンプである必要があります。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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 は、請求サイクルアンカーまでの比例配分が適用された期間ではなく、請求サイクルアンカーから始まる期間全体を表示して請求します。

## 比例配分の無効化

比例配分を無効にするには、Checkout セッションの作成時に `subscription_data.proration_behavior` パラメーターを `none` に設定します。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-line_items) と [total details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) に関連付けられている金額が常に 0 になります。また、決済が将来の日付に先送りされることを反映してセッションの [payment status](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-payment_status) が `no_payment_required` に設定されます。

## 制限事項

- 請求サイクルの起点を設定した Checkout セッションでトライアルを利用することはできません。
- `proration_behavior` が `none` の場合、Checkout セッションでは 1 回限りの価格は使用できません。
- デフォルトの `proration_behavior` が `create_prorations` になっている Checkout セッションでは、[amount_off クーポン](https://docs.stripe.com/api/coupons/create.md#create_coupon-amount_off)を適用することはできません。


# 埋め込みページ

> This is a 埋め込みページ for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/billing-cycle?payment-ui=embedded-form.

Checkout セッションの作成時に、サブスクリプションの[請求サイクルの起点](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-billing_cycle_anchor)を固定の日付 (翌月の第 1 日など) に明示的に設定できます。請求サイクルの起点によって、最初の満額請求日 (顧客にサブスクリプションの全額を請求する日) が決まります。また、請求サイクルの起点と、その[料金](https://docs.stripe.com/products-prices/overview.md)の繰り返し間隔によって、サブスクリプションの将来の請求日も決まります。たとえば、月次サブスクリプションが 5 月 15 日に作成され、その起点が 6 月 1 日に設定されている場合、請求は 5 月 15 日に行われ、その後は常に毎月 1 日に請求されます。

最初の請求期間から最初の満額請求日までは、[proration_behavior](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-proration_behavior) パラメーターを使用して [比例配分](https://docs.stripe.com/billing/subscriptions/prorations.md)の処理方法をカスタマイズできます。デフォルトでは、`proration_behavior` は `create_prorations` に設定されており、顧客は比例配分された*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)を受け取ります。`proration_behavior` が `none` の場合、顧客は最初の期間を、最初の満額請求日までは無料で利用できます。

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

請求書サイクルのアンカーを設定するには、`subscription` モードで checkout セッションを作成するときに `subscription_data.billing_cycle_anchor` パラメーターを設定します。このアンカーは、次回の定期決済の請求日より前の将来の unix タイムスタンプである必要があります。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "line_items[0][price]={{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=subscription \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]=1611008505"
```

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

## 比例配分の無効化

比例配分を無効にするには、Checkout セッションの作成時に `subscription_data.proration_behavior` パラメーターを `none` に設定します。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "line_items[0][price]={{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=subscription \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]=1611008505" \
  -d "subscription_data[proration_behavior]=none"
```

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

比例配分を無効にすると、Checkout セッションの応答オブジェクトで、[line items](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-line_items) と [total details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) に関連付けられている金額が常に 0 になります。また、決済が将来の日付に先送りされることを反映してセッションの [payment status](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-payment_status) が `no_payment_required` に設定されます。

## 制限事項

- 請求サイクルの起点を設定した Checkout セッションでトライアルを利用することはできません。
- `proration_behavior` が `none` の場合、Checkout セッションでは 1 回限りの価格は使用できません。
- デフォルトの `proration_behavior` が `create_prorations` になっている Checkout セッションでは、[amount_off クーポン](https://docs.stripe.com/api/coupons/create.md#create_coupon-amount_off)を適用することはできません。


## See also

- [比例配分 (日割り / 秒割り計算)](https://docs.stripe.com/billing/subscriptions/prorations.md)