コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
バージョン管理
変更ログ
    概要
    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
パートナー認定
アメリカ
日本語
ホーム開発者向けリソースChangelogBasil2025-03-31.basil

メモ

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

請求リソースに、その作成方法が指定されるようになりました互換性に関わる変更

新規情報

請求書、インボイスアイテム、請求書の項目に新しい parent フィールドが導入されます。parent フィールドを使用すると、請求書、インボイスアイテム、請求書の項目 (サブスクリプション、見積もりなど) を生成したアップストリームオブジェクトの詳細を表示できます。以前はこれらのオブジェクトを参照するために使用していた最上位フィールドが、parent フィールドに置き換えられます。

この変更により互換性が失われる理由

  • 請求書オブジェクトで、見積もり、サブスクリプション、subscription_details、subscription_proration_date の各フィールドが廃止されました。
  • インボイスアイテムオブジェクトで、subscription_item と サブスクリプション フィールドが廃止されました。
  • Invoice Line Itemオブジェクトで、type、subscription、subscription_item、invoice_item、proration、proration_details の各フィールドが廃止されました。

影響

請求関連オブジェクトのフィールド参照を parent フィールドの新しい場所に置き換えます。

請求書オブジェクトの場合:

  • invoice.subscription の代わりに invoice.parent.subscription_details.subscription を使用します (invoice.parent.type が subscription_details であることを確認してください)。
  • これは、以下にも適用されます。
    • quote
    • subscription_details
    • subscription_proration_date

インボイスアイテムオブジェクトの場合:

  • invoice_item.subscription の代わりに invoiceitem.parent.subscription_details.subscription を使用します (invoiceitem.parent.type が subscription_details であることを確認してください)。
  • これは subscription_item フィールドにも適用されます

Invoice Line Itemオブジェクト:

  • line_item.subscription_item の代わりに line_item.parent.subscription_item_details.subscription_item を使用します (line_item.parent.type が subscription_item_details であることを確認してください)。
  • これは、以下にも適用されます。
    • subscription
    • invoice_item
    • proration
    • proration_details

変更点

パラメーター変更するリソースまたは エンドポイント
subscription_itemsubscription削除済み
InvoiceItem
quotesubscription_detailssubscriptionsubscription_proration_date削除済み
Invoice
invoice_itemproration_detailsprorationsubscriptionsubscription_itemtype削除済み
InvoiceLineItem
parent追加済み
InvoiceItemInvoiceInvoiceLineItem

アップグレード

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

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

関連する変更点

  • サブスクリプション項目の請求期間を追加し、サブスクリプションの期間を削除しました
  • メーターの最後の集計式のサポートを追加
  • 請求メーターの新しい Webhook イベントタイプを追加しました
  • 請求クレジットの新しい Webhook イベントタイプを追加しました
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc