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

注

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

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

新規情報

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

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

  • Invoice (請求書) オブジェクトの quote、subscription、subscription_details、subscription_proration_date フィールドを廃止しました。
  • Invoice Item (請求書品目) オブジェクトの subscription_item フィールドと subscription フィールドを廃止しました。
  • Invoice Line Item (請求書項目) オブジェクトの type、subscription、subscription_item、invoice_item、proration、proration_details フィールドを廃止しました。

影響

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

Invoice オブジェクトの場合:

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

Invoice Item オブジェクトの場合:

  • 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