# サブスクリプション請求の更新日を設定する

サブスクリプションの請求日を設定する方法をご紹介します。

Connect プラットフォームが [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) を使用している場合は、Stripe の [ガイド](https://docs.stripe.com/connect/use-accounts-as-customers.md)をご確認の上、コード内の `Customer` およびイベント参照を同等の Accounts v2 API リファレンスに置き換えてください。

サブスクリプションの請求期間は、次の 2 つの要因により決定されます。

- 単一の[料金](https://docs.stripe.com/products-prices/overview.md)または複数の料金の継続期間 (月次、年次、週次など)。
- [請求サイクルのアンカー](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor)は、今後の請求期間の日付を調整するための参照点です。`week` の期間には曜日、`month` と `year` の期間には日、`year` の期間には月が設定されます。デフォルト値は、サブスクリプションの作成日またはトライアルの終了日 (トライアル期間を使用している場合) です。また、サブスクリプションの作成時にこの値を明示的に設定することもできます。

> 請求サイクルアンカーは、現在のエポックからの秒単位の Unix タイムスタンプです。

以下に、さまざまな請求期間が設定された月次サブスクリプションの例を示します。

- 請求サイクルの起点の日付が 9 月 2 日の月次サブスクリプションの場合、常に毎月 2 日に請求されます。
- 請求サイクルの起点の日付が 1 月 31 日の月次サブスクリプションの場合、請求日は起点の日付に最も近いその月の最終日になります。したがって、請求日は 2 月 28 日 (うるう年の場合は 2 月 29 日)、3 月 31 日、4 月 30 日というようになります。
- 請求サイクルの起点の日付が 6 月 3 日 (金) の週次サブスクリプションの場合、翌週から毎週金曜日に請求されます。

完全な請求期間は、全額が請求される最初の*請求書* (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)の日付に開始されます。多くの場合、その日付は請求サイクルの起点と同じであり、必ずこれに合わせて期間が調整されます。

## 新しいサブスクリプションの請求サイクルの起点を指定する

> サブスクリプションの作成時刻はリクエストの時刻と同じです。サブスクリプションの開始日とは異なります。[遡及と請求サイクルアンカー](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-billing-cycle)の詳細をご確認ください。

新しいサブスクリプションの請求サイクルの起点を指定する方法として、以下の 2 つがあります。

- `billing_cycle_anchor_config` を使用して、タイムスタンプを計算する (月次または年次のサブスクリプションのみ).
- `billing_cycle_anchor` を使用して、タイムスタンプを直接受け付ける。

月次または年次のサブスクリプションを作成している場合、短い月とうるう年が自動的に考慮される `billing_cycle_anchor_config` パラメーターの使用をお勧めします。日次または週次のサブスクリプションを作成している場合、またはタイムスタンプを使用してサブスクリプションの更新日を設定したい場合、`billing_cycle_anchor` パラメーターを直接使用します。

### billing_cycle_anchor_config を使用する

月次と年次のサブスクリプションを組み合わせて作成する場合は、[サブスクリプションの作成](https://docs.stripe.com/api.md#create_subscription)の `billing_cycle_anchor_config` を使用して、起点となる日付を指定します。

`day_of_month` を `31` に設定すると、日数が 31 日未満の月であっても月末に更新される月次サブスクリプションを作成できます。日数が 31 日未満の月には、その月の最終日にサブスクリプションが更新されます。

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{{PRICE_ID}}" \
  -d "billing_cycle_anchor_config[day_of_month]"=31
```

`month` を指定して、複数月および年次のサブスクリプションで起点となる月を管理することもできます。

年次サブスクリプションの開始を 7 月 1 日とするには、`month` を `7`、`day_of_month` を `1` に指定して年次サブスクリプションを作成します。

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{{PRICE_ID}}" \
  -d "billing_cycle_anchor_config[month]"=7 \
  -d "billing_cycle_anchor_config[day_of_month]"=1
```

`billing_cycle_anchor_config` を使用して請求サイクルの起点の正確な月、日、時、分、秒を指定できます。時、分、秒を指定しない場合、デフォルトはサブスクリプションの作成時刻の値になります。

請求サイクルの起点には協定世界時 (UTC) が用いられています。たとえば、時間を指定せずに午後 5 時 (東部標準時) に `billing_cycle_anchor_config` を使用してサブスクリプションを作成した場合、時刻は午後 10 時 (UTC) としてシステムに記録されます。

`billing_cycle_anchor_config` は、遡及的な開始日による固定をサポートしていません。

たとえば、既存の月次サブスクリプションにおいて、日、時、分、秒 として 15、12、30、0 を含む `billing_cycle_anchor` タイムスタンプが指定されている場合、新しい月次サブスクリプションをこれに合わせることができます。そのためには、`day_of_month`、`hour`、`minute`、`second` を既存のサブスクリプションと同じ値に設定します。

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{{PRICE_ID}}" \
  -d "billing_cycle_anchor_config[day_of_month]"=15 \
  -d "billing_cycle_anchor_config[hour]"=12 \
  -d "billing_cycle_anchor_config[minute]"=30 \
  -d "billing_cycle_anchor_config[second]"=0
```

`billing_cycle_anchor_config` を使用すると、結果的に `billing_cycle_anchor` が将来の 1 請求期間を超える場合がありますが、全額が請求される最初の請求書の日付は常に、サブスクリプションの作成または無料トライアルの終了から 1 請求期間以内になります。

たとえば、請求期間が 2 カ月のサブスクリプションを 2 月に作成し、`day_of_month` を `31` に設定して請求サイクルを各月の最終日にするとします。2 カ月の請求期間を 2 月に開始した場合、31 日がある次の月は 8 月であるため、請求サイクルの起点は 8 月 31 日となります。ただし、全額が請求される最初の請求書の日付は、2 月のままです。サブスクリプションの作成から 2 月 28 日 (うるう年の場合は 29 日) までは最初の比例配分の期間であり、その後に通常の 2 カ月ごとの請求サイクルが開始されます。

### billing_cycle_anchor を使用する

Subscriptions API または Checkout を使用して、明示的な請求サイクルの起点を指定したサブスクリプションを作成できます。

#### 定期支払い API

`billing_cycle_anchor` のタイムスタンプを設定して、[サブスクリプションの作成](https://docs.stripe.com/api.md#create_subscription)を呼び出します。

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{{PRICE_ID}}" \
  -d billing_cycle_anchor=1611008505
```

### 比例配分 (日割り / 秒割り計算) の動作を設定する

使用する API パラメーターに関係なく、サブスクリプションの作成日から全額が請求される最初の請求書の日付までの期間について、Stripe は自動的に比例配分が適用された請求書を作成します。

サブスクリプションの作成から全額が請求される最初の請求書の日付までの期間について、顧客への請求を直ちに行いたくない場合は、次のいずれかの方法を使用します。

- `proration_behavior` を `none` に設定することで、[比例配分を無効化](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations)します。これにより、全額請求される最初の請求書の日付までの期間が無料になります。そのため、最初の請求期間まで請求書は生成されません。
- `trial_end` に無料トライアルが終了する日付を表すタイムスタンプを設定して [billing_cycle_anchor](https://docs.stripe.com/billing/subscriptions/trials.md#combine-trial-anchor) と組み合わせます。この方法を使用した場合、無料トライアルの期間と最初の全額請求書日までの日数によっては、最初のトライアル期間の後に比例配分された請求書が生成される可能性があります。たとえば、無料トライアル期間が 7 日で請求の更新が毎月 1 日に行われる場合、顧客が 15 日にサブスクリプションに登録した場合、22 日から毎月 1 日までの期間について比例配分された請求書が 22 日に生成され、その後は毎月 1 日に全額請求書が生成されます。顧客が 28 日にサブスクリプションに登録した場合、無料トライアルは 1 日を超えて延長され、比例配分された請求書が翌月まで生成されます。

#### Checkout

`subscription_data.billing_cycle_anchor` のタイムスタンプを指定して、Stripe Checkout の[セッションの作成](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session)を呼び出します。

#### cURL

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

Checkout で請求サイクルアンカーを設定するには、`subscription` モードである必要があります。

### 比例配分 (日割り / 秒割り計算) の動作を設定する

`proration_behavior` パラメーターを使用して、サブスクリプションの作成から、全額が請求される最初の請求書の日付までの期間をどのように処理するかを設定できます。Checkout ではトライアルと請求サイクルの起点の組み合わせはサポートされていません。

- デフォルトの `create_prorations` 設定を維持し、サブスクリプションの日付から、全額が請求される最初の請求書の日付までの期間について、顧客に対して直ちに請求書が発行されるようにします。
- `proration_behavior` を `none` に設定することで、[比例配分を無効化](https://docs.stripe.com/payments/checkout/billing-cycle.md?ui=embedded-form#disable-prorations)します。これにより、全額請求される最初の請求書の日付までの期間が無料になります。そのため、最初の請求期間まで請求書は生成されません。

> `proration_behavior` が `none` の場合、Checkout セッションでは 1 回限りの価格は使用できません。

## 既存サブスクリプションの請求期間変更

[Subscriptions API](https://docs.stripe.com/api/subscriptions/update.md) または[ダッシュボード](https://dashboard.stripe.com/subscriptions)を使用し、既存のサブスクリプションの請求日を以下のいずれかのオプションの中から変更します。

- 請求サイクルの起点を現在時刻にリセットします。
- [無料トライアル](https://docs.stripe.com/billing/subscriptions/trials.md)を追加して、起点の日付がトライアルの終了日に自動的に設定されるようにします。トライアルは通常、サブスクリプションの作成時に開始しますが、既存のサブスクリプションに適用することもできます。これにより、顧客がすでに支払った前のサイクルの残り日数分について顧客にクレジットすることができます。

請求サイクルの日付は、このようなシナリオで変わります。ただし、`billing_mode[type]=flexible` を指定してサブスクリプションを作成または更新した場合、請求サイクルの起点は変更されません。詳しくは、[柔軟な請求モードの設定](https://docs.stripe.com/billing/subscriptions/billing-mode.md)とその[制限事項](https://docs.stripe.com/billing/subscriptions/billing-mode.md#limitations)をご覧ください。

- すべての価格がゼロ金額の場合、1 つ以上の有料価格を追加すると、請求期間が即座にリセットされます。詳細については、[サブスクリプション価格の変更ガイド](https://docs.stripe.com/billing/subscriptions/change-price.md#handle-zero-amount-prices-and-quantities) をご覧ください。
- `billing_cycle_anchor` が [cancel_at](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-cancel_at) の日付にリセットされるのは、`cancel_at` を次にサブスクリプションが更新される前の日付に設定してサブスクリプションを作成するか、`billing_cycle_anchor` が新しい `cancel_at` 日付よりも将来の日付に設定されているサブスクリプションで既存の `cancel_at` の日付を変更する場合です。
- 異なる [recurring.interval](https://docs.stripe.com/api/prices/object.md#price_object-recurring) の料金に切り替えると、`billing_cycle_anchor` が現在の時刻にリセットされます。

### 請求期間を現在時刻にリセットする

請求サイクルの起点を現在時刻にリセットするには、`billing_cycle_anchor` を `now` に設定して更新リクエストを実行します。これにより、請求サイクルの起点が更新リクエストの時刻に設定されます。請求サイクルの起点をリセットすると、Stripe は直ちに請求書を送信します。前の期間に既に支払った日数分を顧客にクレジットできるよう、[比例配分を有効](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-proration_behavior)にしてください。比例配分を無効にすると、顧客に過剰な請求をする可能性があります。

#### API

顧客が前のサイクルで支払った日数分による過剰請求を防ぐには、`billing_cycle_anchor`を`now`に設定し、`proration_behavior` を `create_prorations` に設定して[サブスクリプションの更新](https://docs.stripe.com/api.md#update_subscription)を呼び出します。

```curl
curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d billing_cycle_anchor=now \
  -d proration_behavior=create_prorations
```

#### ダッシュボード

1. [サブスクリプションの概要](https://docs.stripe.com/api/subscriptions.md)から、オーバーフローメニュー⋯をクリックし、**サブスクリプションの更新**を選択します。
1. **詳細設定**までスクロールして、**請求サイクルをリセット**を選択します。
1. **比例配分による調整**トグルを選択して、前のサイクルですでに支払われている日数分に対する過剰請求を防ぎます。
1. **サブスクリプションを更新**をクリックします。

### トライアル期間を使用した請求期間の変更

[無料トライアル](https://docs.stripe.com/billing/subscriptions/trials.md)を利用して、請求サイクルの起点日を自動的に `trial_end` 日に設定することで請求サイクルの起点を変更できます。

例えば、顧客が 7 月 23 日に次回請求予定のアクティブなサブスクリプションを持っており、7 月 15 日に 8 月 1 日終了のトライアル期間を導入したとします。

- 顧客は 7 月 15 日に 0 USD の請求書を受け取ります。顧客は前回のサイクルで 7 月 23 日まで既に支払い済みのため、「無料」期間は 7 月 24 日から 7 月 31 日までのみ適用されます。
- 顧客は 7 月 23 日には請求されません。
- 8 月 1 日に請求される新しいサイクルは通常料金での完全なサイクルとなり、その後は毎月 1 日に継続されます。

オプションで、`proration_behavior=none` を使用して、トライアルを開始するようにサブスクリプションを更新するときに比例配分を適用しないようにできます。ほとんどの場合、比例配分請求書を発行せずに請求期間を変更するためにトライアル期間を使用している場合は、比例配分を無効にします。これは、トライアル期間の長さが、以前の請求期間からすでに決済された部分を占めるためです。

#### API

[サブスクリプション更新](https://docs.stripe.com/api.md#update_subscription)を呼び出し、`trial_end` をトライアル終了日を表す Unix タイムスタンプに設定し、`proration_behavior` を `none` にします。`trial_end` を設定すると、請求サイクルの起点が同じ日付に設定されます。

```curl
curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d trial_end=1627801200 \
  -d proration_behavior=none
```

#### ダッシュボード

1. [サブスクリプションの概要](https://docs.stripe.com/api/subscriptions.md)から、変更するサブスクリプションを選択し、その詳細ページを開きます。
1. **アクション** > **サブスクリプションを更新**をクリックします。
1. **トライアルを追加**をクリックして、トライアルの日数を入力します。トライアルの終了日が新しい請求サイクルの起点の日付になります。
1. **比例配分による調整**トグルの選択を解除して、すでに支払われている日数分について顧客にクレジットするのを防ぎます。
1. **サブスクリプションを更新**をクリックします。

## 従量課金ベース

[従量課金](https://docs.stripe.com/products-prices/pricing-models.md)を使用すると、請求期間中の使用量に応じて顧客が支払う価格が変動します。請求期間を変えると、サブスクリプションのサービス期間の終了が早まり、短縮された請求期間中に発生した使用量に対して顧客に請求することになります。

### しきい値

通常のサイクルに加えて、請求金額が[しきい値](https://docs.stripe.com/billing/subscriptions/usage-based/thresholds.md)に達したときに請求するようにサブスクリプションを設定できます。

この方法で請求するようにサブスクリプションを設定している場合、しきい値に達したときにサブスクリプションのサービス期間をリセットするように設定できます。

## See also

- [トライアル期間の使用](https://docs.stripe.com/billing/subscriptions/trials.md)
- [サブスクリプションの更新](https://docs.stripe.com/api.md#update_subscription)