コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
バージョン管理
変更ログ
    概要
    Clover
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
Stripe CLI
サンプルプロジェクト
ツール
Stripe ダッシュボード
ワークベンチ
開発者ダッシュボード
Stripe Shell
Visual Studio Code をご利用の場合
機能
ワークフロー
イベントの送信先
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
プライバシー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けリソースChangelogClover2025-09-30.clover

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

比例配分割引額を明細化する機能を追加

新機能

比例配分割引額を明細化する機能が追加され、比例配分金額と割引額が非比例配分と一貫して表示されます。有効にすると、比例配分 金額 プロパティには割引が適用される前の総金額が表示され、割引金額 には、実際に適用された割引金額が含まれます。無効にすると、比例配分割引プロパティには割引 ID が含まれますが、割引額は 0 です。

影響

You can now itemize proration discount amounts by setting the proration_discounts parameter to itemized when creating subscriptions, subscription schedules, quotes, checkout sessions, or preview invoices. You can also set this parameter to itemized for an existing subscription by migrating it. However, you can’t migrate a subscription from itemized to included.

変更の概要

オブジェクトプロパティ含まれる機能項目別 (新しい動作)
比例配分項目amount正味金額 (割引後)総額 (割引前)
discount_amounts商品レベルの割引の不足。グループレベルの割引は、amount=0 を表示正確な金額に含まれるすべての割引
インボイスアイテムamount正味金額総額
net_amount (新しいプロパティ)割引不可のインボイスアイテムの正味金額。それ以外の場合は null割引不可のインボイスアイテムの正味金額。それ以外の場合は null
proration_details (新しいプロパティ)amount=0 に含まれるすべての割引正確な金額に含まれるすべての割引
請求書total_discount_amounts比例配分割引を除く比例配分割引あり
subtotal正味の比例配分金額を含みます (割引はすでに適用されています)項目別割引後の比例配分金額あり (グループ別割引は別途適用)

例: 10 USD の総借方比例配分、10% の項目レベル割引と 2 USD のグループレベルの割引

あり:

次の例は、割引が既に適用されている既存の動作を示しています。

レスポンス:

// Line Item { "proration": true, "amount": 700, // Net: 7 USD after discounts (10 USD - 1 USD item - 2 USD group) "discount_amounts": [ // Item-level discount missing entirely {"amount": 0, "discount": "di_group_2off"} // Group-level shows ID but no amount ] } // Invoice Item { "proration": true, "amount": 700 // Net amount only } // Invoice { "total_discount_amounts": [ {"amount": 0, "discount": "di_group_2off"} // Missing item-level proration discount ], "subtotal": 700 // Adds proration amount after all discounts }

項目別:

リクエスト:

// POST /v1/subscriptions { // ... omitting irrelevant fields ... billing_mode: { type: "flexible", flexible: { // New parameter: only available when billing mode type is flexible proration_discounts: "itemized" // Default value is "included" } } // ... omitting irrelevant fields ... }

レスポンス:

// Line Item { "proration": true, "amount": 1000, // Gross: 10 USD before discounts "discount_amounts": [ {"amount": 100, "discount": "di_item_10pct"}, // Item-level discount now visible {"amount": 200, "discount": "di_group_2off"} // Group-level with actual amount ] } // Invoice Item { "proration": true, "amount": 1000, // Gross amount "net_amount": 700, // New property: net amount after both discounts "proration_details": { // New property: populated when the invoice item is a proration "discount_amounts": [ {"amount": 100, "discount": "di_item_10pct"}, {"amount": 200, "discount": "di_group_2off"} ] } } // Invoice { "total_discount_amounts": [ {"amount": 100, "discount": "di_item_10pct"}, // Now includes item-level proration discount {"amount": 200, "discount": "di_group_2off"} // Now includes group-level proration discount ], "subtotal": 9000 // Includes proration amount after item-level discounts }

アップグレードに関する考慮事項

  • 範囲: この機能は、柔軟な課金モードのサブスクリプションでのみ使用できます。
  • 一方向の移行: サブスクリプションの項目別割引金額を有効にした後は、含まれる割引額に戻すことはできません。
  • コードの変更が必要: 導入により、正味値を期待する比例配分 金額 プロパティが読み取られる場合は、代わりに新しい net_amount プロパティを使用するように更新します。
  • 過去の請求書: 既存の請求書には、請求書の作成時にアクティブであった動作が反映されます。
  • 混合請求書のサポート: 比例配分の作成の間にサブスクリプションを移行する場合、1つの請求書には、含まれる比例配分明細項目と項目別の比例配分明細項目の両方を含めることができます。

変更点

パラメーター変更するリソースまたは エンドポイント
flexible追加済み
Checkout.Session#create.subscription_data.billing_modeInvoice#create_preview.schedule_details.billing_modeInvoice#create_preview.subscription_details.billing_mode
 + さらに 7 件
Quote#create.subscription_data.billing_modeQuote.subscription_data.billing_modeSubscription#create.billing_modeSubscription#migrate.billing_modeSubscription.billing_modeSubscriptionSchedule#create.billing_modeSubscriptionSchedule.billing_mode
net_amountproration_details追加済み
InvoiceItem

アップグレード

  1. Workbench で現在の API バージョンを表示します。
  2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
    • SDK を使用していない場合は、Stripe-Version: 2025-09-30.clover を含めるように API リクエストを更新してください。
  3. Webhook エンドポイントに使用する API バージョンをアップグレードします。
  4. 新しいバージョンに対して、実装内容をテストします。
  5. Connect を使用する場合は、Connect の実装内容をテストします。
  6. Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。

関連する変更

  • Removes iterations parameter for subscription schedules
  • Promotion Codes now reference Coupons using a polymorphic field for promotions
  • 割引ソースプロパティを追加して、割引クーポンプロパティを削除する
  • Makes flexible billing mode the default for new subscriptions
  • Updates computation of subscription schedule phase end date to consider billing cycle anchor changes
  • Adds customer portal configuration trial behavior
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc