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

サブスクリプションは周期的に請求されます。請求日の設定方法は以下のとおりです。

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

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

注

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

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

請求サイクルの起点の日付が 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 日未満の月には、その月の最終日が起点となります。

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

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

請求サイクルをほかのサブスクリプションと厳密に一致させるには、元の日付と同じ day_of_month、month、hour、minute、second を指定します。hour、minute、second パラメーターを省略すると、サブスクリプションの作成時間から取得されます。

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

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 を使用して、明示的な請求サイクルの起点を指定したサブスクリプションを作成できます。

billing_cycle_anchor のタイムスタンプを設定して、サブスクリプションの作成を呼び出します。

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

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

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

proration_behavior を none に設定することで、比例配分を無効化します。これにより、全額請求される最初の請求書の日付までの期間が無料になります。そのため、最初の請求サイクルまで請求書は生成されません。
trial_end に無料トライアルが終了する日付を表すタイムスタンプを設定してトライアルと billing_cycle_anchor を組み合わせます。この方法を使用した場合、無料トライアルの期間と、全額請求される最初の請求書の日付までの日数によっては、トライアル期間後に比例配分された請求書が生成される可能性があります。たとえば、無料トライアルが 7 日間で、請求サイクルが月次で毎月 1 日に請求される場合を考えます。顧客が 15 日にサブスクリプションに登録した場合、22 日から 1 日までの期間について比例配分された請求書が 22 日に生成され、その後は毎月 1 日に全額の請求書が生成されます。顧客が 28 日にサブスクリプションに登録した場合、無料トライアルは 1 日を超えて延長され、翌月までの比例配分された請求書が生成されます。

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

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

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

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

請求サイクルをリセットすると、請求書が直ちに送信されます。顧客が前の期間にすでに支払った日数分について顧客にクレジットするには、比例配分を有効にします。比例配分を無効にすると、顧客への過大請求が発生する可能性があります。

顧客が前のサイクルで支払った日数分による過剰請求を防ぐには、billing_cycle_anchorをnowに設定し、proration_behavior を create_prorations に設定してサブスクリプションの更新を呼び出します。

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

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

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

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

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

trial_end にトライアルの終了日 (新しい請求サイクルの起点でもある) を表す Unix タイムスタンプを設定し、proration_behavior を none に設定してサブスクリプションの更新を呼び出します。

従量課金

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

しきい値

定期的なサイクルに加えて、請求額がしきい値に達するたびに、サブスクリプションの請求が行われるよう設定できます。

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

詳細については、請求しきい値をご覧ください。