サブスクリプションの請求サイクル日を設定する

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

• 単一の料金または複数の料金の継続期間 (月次、年次、週次など)。
• billing cycle anchor (請求サイクルの起点) は、今後の請求サイクルの日付を調整するための参照先です。week の期間には曜日、month と year の期間には日、year の期間には月が設定されます。デフォルト値は、サブスクリプションの作成日またはトライアルの終了日 (トライアル期間を使用している場合) です。また、サブスクリプションの作成時にこの値を明示的に設定することもできます。

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

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

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

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

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

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

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

billing_cycle_anchor_config を使用する

月次と年次のサブスクリプションを組み合わせて作成する場合は、サブスクリプションの作成の billing_cycle_anchor_config を使用して、起点となる日付を指定します。

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

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 を使用して、明示的な請求サイクルの起点を指定したサブスクリプションを作成できます。

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

既存のサブスクリプションの請求サイクルを変更する

Subscriptions API またはダッシュボードを使用し、既存のサブスクリプションの請求日を以下のいずれかのオプションの中から変更します。

• 請求サイクルの起点を現在時刻にリセットします。
• 無料トライアルを追加して、起点の日付がトライアルの終了日に自動的に設定されるようにします。トライアルは通常、サブスクリプションの作成時に開始しますが、既存のサブスクリプションに適用することもできます。これにより、顧客がすでに支払った前のサイクルの残り日数分について顧客にクレジットすることができます。
• すべての料金がゼロの場合、有料の料金を 1 つ以上追加すると、請求期間がすぐにリセットされます。このシナリオの詳細については、サブスクリプション料金変更ガイドをご覧ください。

請求サイクルを現在時刻にリセットする

請求サイクルの起点をリセットするには、billing_cycle_anchor を now に設定して更新リクエストを実行します。そうすることで、請求サイクルの起点が更新リクエストの時刻に設定されます。請求サイクルの起点をリセットすると、Stripe は直ちに請求書を送信します。比例配分を有効にすると、前の期間に支払い済みの日数があれば、その日数分のクレジットを顧客に付与します。比例配分を無効にすると、顧客に過剰請求する可能性があります。

トライアルを追加して請求サイクルを変更する

既存のサブスクリプションに対して、比例配分が適用されないトライアル期間を追加すると、請求サイクルを任意の日付に設定できます。

比例配分が適用された請求書を発行せずに請求サイクルを変更するためにトライアル期間を使用する場合、通常は比例配分を無効にします。これは、前の請求サイクルですでに支払われた分がトライアル期間の長さで考慮されるためです。

たとえば、顧客の有効なサブスクリプションの次回請求日が 7 月 23 日に設定されている場合に 8 月 1 日までのトライアル期間を導入すると、以下のようになります。

• 顧客は 7 月 15 日に 0 USD の請求書を受け取ります。
• 顧客は 7 月 23 日には請求されません。
• 顧客への次回請求日は 8 月 1 日、その次は 9 月 1 日となります。
• 顧客は前のサイクルで 7 月 23 日までの分をすでに支払っているので、その「無料」期間は実際には無料期間ではありません。
• 7 月 23 日から 7 月 31 日までの期間は請求されません。
• 8 月 1 日が請求日の新しいサイクルは、通常料金で請求される完全なサイクルです。

従量課金

従量課金を使用すると、請求サイクル中の使用量に基づいて顧客が支払う料金が変わります。請求サイクルを変えると、サブスクリプション期間の終了が早まり、顧客は短縮された請求サイクル中に発生した使用量に対して請求されます。