将来の日付で請求書を確定して送信または請求するようにスケジュールを設定する

Stripe は、請求書を自動的に確定するタイミングを設定できる機能を提供しています。請求書は、顧客に送信する前や自動請求する前に確定する必要があります。この機能は、たとえば、特定の時点で請求書の作成と入力を行い、その請求書を確定して送信または請求する処理は後で行う場合に使用します。この請求書の下書きは、請求書が自動的に確定されるまでは編集できます。また、必要に応じて、確定のスケジュールを解除することもできます。 Stripe は設定された予定時刻にこの請求書を確定するよう試みます。確定中にエラー が発生しなければ、確定は成功します。

はじめに

請求書の自動確定時刻を設定するには、請求書で請求書の自動進行を有効にする必要があります。ダッシュボードでスケジュールを設定した請求書は、この設定が自動的に有効になります。API で請求書の自動進行を有効にするときに automatically_finalizes_at の値を渡さないと、Stripe は現在設定されている設定可能な猶予期間に従って時刻を計算して設定します。自動進行をオフにすると、その請求書の自動請求や自動送信は無効になります。詳細は請求書の自動進行を一時停止するをご覧ください。

1 回限りの請求書を確定する予定を設定する

スケジュール設定した請求書を表示する

ダッシュボードでは、スケジュール設定済みの請求書をさまざまな方法で確認できます。

• 請求書ページの Scheduled finalization 列と Scheduled finalization date フィルターに基づいて、請求書の確定スケジュールが有効になっているかどうかで請求書を絞り込むことができます。

• 特定の請求書のページの詳細セクションにある Finalizes at プロパティーは、その請求書の確定予定日を示します。

サブスクリプションの請求書の取り扱い

サブスクリプションによって生成された請求書は、請求書の作成時に確定スケジュールがすでに設定されています。確定予定日は、現在設定されている設定可能な猶予期間に基づいて設定されます。自動進行をオフにすると、その請求書の自動請求や自動送信は無効になります。設定項目については、請求書の自動進行を一時停止する方法をご覧ください。ここで説明している手順で請求書を変更できますが、必ず次の点を考慮してください。

• 確定されていない請求書は下書きの状態のままです。このため、確定予定日をさらに先延ばしすると、請求書を顧客に送信したり請求したりせずに、顧客が有効なサブスクリプションを受けられる期間が延びる可能性があります。
• この時間を変更しても、invoice.created Webhook への応答の失敗に基づいて請求書の確定が遅延することはありません。Webhook が失敗した場合に請求書の確定を遅延するようにするには、この automatically_finalizes_at フィールドを変更しないでください。

よくある落とし穴

この機能には、注意すべき落とし穴がいくつかあります。

• 請求書が automatic_tax[enabled]=true であるのに、顧客の税務情報が不足していると、自動確定が失敗します。請求書の確定エラーとその解決方法をご覧ください。
• 自動確定された請求書をメールで顧客に送信する場合は、サブスクリプションとメール通知の設定で確定済みの請求書とクレジットノートを顧客に送信の設定を有効にする必要があります。
  • 自動確定された請求書をメールで送信するこの機能は、本番環境でのみご利用いただけます。