コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要
Billing
概要Billing API について
Invoicing
税金
概要
レポート機能
概要複数のアカウントのレポート
データ
概要スキーマ

請求書の支払いプランを作成非公開プレビュー

Stripe 請求書の支払いプランを作成する方法をご確認ください。

請求書の支払いプランを設定する場合、請求書の合計金額を支払い期日ごとに分割できます。これにより、請求の柔軟性が高まります。たとえば、最初に手付金を回収し、後日取引の残高を回収することができます。あるいは、請求額を顧客にとって都合のよい期間 (長期) にわたって複数の支払いに分割することも可能です。Stripe は顧客に次回の支払いについてリマインドメールを送信し、そのメールに過去の支払い履歴を表示します。ダッシュボードと API の両方を使用して支払いプランを生成できます。

プライベートプレビュー

この機能は非公開プレビュー版です。下記のフォームに必要事項をご記入の上、リクエストしてください。

制限事項

支払いプランはベータ機能であり、いくつかの重要な制限があります。以下の制限がユースケースで問題ないことを確認してください。

  • 支払いプランは、Stripe Revenue Recognition または Stripe Connector for: NetSuite ではサポートされていません。
  • Stripe Tax は一部返金をサポートしていないため、仮受消費税は正確に反映されません。税務アドバイザーにご相談ください。
  • 支払いプランでは、保存された支払い詳細を使用して顧客に自動請求は行われません。顧客は支払いページに戻って後続の支払いを行う必要があります。これらは charge_automaticallyの請求書には使用できません。
  • Stripe は、後続の支払いを完了するように顧客にリマインドメールを自動的に送信します。デフォルトでは、これらのメールは支払い期日の 1 週間前に送信されます。このメールを送信すると、1 回限りの請求書のリマインドメールのスケジュールと設定が上書きされます。確定済みのインボイスとクレジットノートを顧客に送信 の設定を無効にすることで、リマインドメールを無効にできます。
  • 連結ユーザーの場合、支払いプランが有効な請求書にプラットフォーム手数料を設定することはできません。PaymentIntents の手数料のみを設定できます。
  • 支払いプランに関連付けられた追加フィールドは、Sigma で使用できません。
  • 一部の Billing Analytics チャート (上位のサブスクリプション登録者、回収) では、全額が支払われた請求書のみが登録されます。その他のチャートには影響しません。
  • サブスクリプションの請求書には、支払いプランを適用できません。

注

B2C 請求書で今すぐ購入、後で支払うを有効にする場合は、今すぐ購入、後で支払うガイドで詳細をお読みください。

このガイドでは、Invoicing API の amounts_due フィールドを使用して、支払いプランを設定・管理する方法をご紹介します。

補足オブジェクトを作成する

支払いプランを設定する前に、必ず Invoicing API の実装ガイドで概念をご確認ください。この機能を使用するには、Stripe API またはダッシュボードを使用した商品、価格、顧客の作成方法を理解している必要があります。

支払いプランを含む請求書を作成する

amounts_due フィールドは、Stripe Invoices で支払いプランを設定するのに役立ちます。この機能を使用するには、請求書の collection_method を send_invoice に設定します。支払いプランは、charge_automatically 請求書ではサポートされていません。

このセクションでは、支払いプランの一般的な 2 つのユースケースである、柔軟な支払い期間と頭金について説明します。

柔軟な支払い期間

支払いプランは、顧客の請求金額を細かい金額に分割する場合に使用します。たとえば、6,000 USD の請求書があり、3 回に分けて顧客に支払ってもらうとします。この場合、以下のように、amounts_due フィールドを使用して支払いプランを設定できます。

Command Line
cURL
No results
curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; invoice_payment_plans_beta=v1" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d collection_method=send_invoice \
  -d auto_advance=true \
  -d "anounts_due[0][amount]"=2000 \
  -d "anounts_due[0][days_until_due]"=30 \
  -d "anounts_due[0][description]"="Payment 1" \
  -d "anounts_due[1][amount]"=2000 \
  -d "anounts_due[1][days_until_due]"=60 \
  -d "anounts_due[1][description]"="Payment 1" \
  -d "anounts_due[2][amount]"=2000 \
  -d "anounts_due[2][days_until_due]"=90 \
  -d "anounts_due[2][description]"="Payment 2"

頭金

状況によっては、頭金の後に、残額を支払いプランで支払ってもらう場合もあるでしょう。たとえば、請求書の金額が 5,000 USD で、最初に頭金として 1,000 USD、残額を 2 回に分けて均等額を支払ってもらうとします。その場合、以下のように支払いプランを設定します。

Command Line
cURL
No results
curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; invoice_payment_plans_beta=v1" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d collection_method=send_invoice \
  -d auto_advance=true \
  -d "anounts_due[0][amount]"=1000 \
  -d "anounts_due[0][days_until_due]"=1 \
  -d "anounts_due[0][description]"=Deposit \
  -d "anounts_due[1][amount]"=2000 \
  -d "anounts_due[1][days_until_due]"=30 \
  -d "anounts_due[1][description]"="Payment 1" \
  -d "anounts_due[2][amount]"=2000 \
  -d "anounts_due[2][days_until_due]"=60 \
  -d "anounts_due[2][description]"="Payment 2"

上記の例では、さまざまな支払い構造のある請求書を対象に、amounts_due を使用して支払いプランを設定する方法を説明しました。留意点として、amounts_due フィールドの合計金額は、請求書の最終 amount_due と一致している必要があります。この例のようにすることで、特定のニーズに合わせてカスタムの支払いプランを作成できるようになります。

支払いプランを更新する

請求書を確定する前に amounts_dueフィールドを更新すると、必要に応じて支払いプランを修正することができます。こうすることで、期日の変更、支払い金額の変更、新しい支払いの追加などの調整を行えるようになります。

days_until_due を使用して支払い期日までの日数を設定するほかに、due_date フィールドを使用して指定の支払い期日を設定することもできます。due_date フィールドを使用すると、支払いの厳密な日付を指定し、支払いプランのカスタムオプションを増やすことができます。

請求書の支払いプランを更新する場合の例を以下に示します。

Command Line
cURL
No results
curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; invoice_payment_plans_beta=v1" \
  -d "anounts_due[0][amount]"=1000 \
  -d "anounts_due[0][due_date]"=1677514200 \
  -d "anounts_due[0][description]"="Updated Payment 1" \
  -d "anounts_due[1][amount]"=3000 \
  -d "anounts_due[1][due_date]"=1678132000 \
  -d "anounts_due[1][description]"="Updated Payment 2"

この例では、days_until_due の代わりに指定の期日を使用するよう請求書の支払いプランを更新しています。また、amounts_due も新しい支払い金額を表示するように調整したため、請求書を確定する前に柔軟に支払いプランを修正できることがわかります。

請求書を確定する

支払いプランを設定し、必要な請求書項目を追加した後、請求書を確定できます。支払いプランの更新、請求書項目の追加や削除、請求書の金額や日付の変更など、確定した請求書を変更することはできません。

請求書を確定する前に、必要な請求書アイテムが追加されていることを確認します。請求書アイテムを追加する方法の例を以下に示します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d invoice=
{{INVOICE_ID}}
 \
  -d "pricing[price]"=
{{PRICE_ID}}
 \
  -d currency=usd

必要な請求書アイテムを追加し、支払いプランが正しく設定されていることを確認したら、請求書の確定に進みます。請求書を確定する方法の例を以下に示します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

請求書を確定したら、支払いのために顧客に送信できます。請求書の修正は、確定前に行う必要があるため、このステップを実行する前に請求書の細部を確認してください。確定については、ステータスの遷移と確定ガイドを参照してください。

猶予期間をより長く設定できます。

請求書の確定後の操作

ただし、支払いプランを含む確定済みの請求書を、修正、無効化、または回収不能としてマークすることができるのは、最初の支払いが受領される前のみです。さらには、支払いプランを Stripe の外部で「支払い済みとしてマーク」できるのは、請求書の残りの全額に対してのみであり、一部の額に対してはマークできません。

このページはお役に立ちましたか。
はいいいえ