コンテンツにスキップ
アカウントを作成
または
サインイン
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

注

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

最上位の価格フィールドを、Invoice Item と Invoice Line Item の価格モデルに置き換えます。互換性に関わる変更

新規情報

Invoice Item (請求書項目) と Invoice Line Item (請求書品目) に、ポリモーフィックの pricing コンセプトを導入する予定です。価格に関連するすべてのデータを含め、価格関連オブジェクト (Price (価格) と Plan (プラン)) の構造を統一して、新しい価格オブジェクトを追加する予定です。また、単位額データも pricing に移行します。

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

  • price フィールドと plan フィールドは、Invoice Item と Invoice Line Item では使用できなくなりました。
  • unit_amount と unit_amount_decimal は、Invoice Item と Invoice Line Item の新しい pricing コンセプトに移行します。

影響

Invoice Item および Invoice Line Item の price と plan への参照を、すべて pricing フィールドに置き換えます。

  • invoice_item.price.id ではなく、invoice_item.pricing.type が price_details であることを確認してから invoice_item.pricing.price_details.price を使用します。
  • Invoice Item を作成または更新するときは、price の代わりに pricing パラメーターを使用します (たとえば、price パラメーターを渡す代わりに pricing.price を設定します)
  • 単位額には、unit_amount または unit_amount_decimal ではなく pricing.unit_amount_decimal を使用します
  • Invoice Item を作成または更新するときは、unit_amount ではなく unit_amount_decimal パラメーターを使用します

変更点

パラメーター変更するリソースまたは エンドポイント
planpriceunit_amount_decimalunit_amount削除済み
InvoiceItem
planprice削除済み
InvoiceLineItem
pricing追加済み
Invoice#add_lines.lines[]Invoice#update_lines.lines[]InvoiceItem#create
 + さらに 4 件
InvoiceItem#updateInvoiceLineItem#updateInvoiceItemInvoiceLineItem
price削除済み
Invoice#add_lines.lines[]Invoice#update_lines.lines[]InvoiceItem#create
 + さらに 4 件
InvoiceItem#updateInvoiceItemInvoiceLineItem#updateInvoiceLineItem
unit_amount削除済み
InvoiceItem#createInvoiceItem#updateInvoiceItem

アップグレード

  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 のアップグレードについて、詳細をご確認ください。

関連する変更点

  • 最上位の税関連プロパティを、Invoice、Invoice Line Item、Credit Note Line Item の新しい税金モデルに置き換えます
  • 請求書の複数 (一部) 支払いのサポートを追加しました
  • 請求書の手動税額に jurisdiction level と taxability reason を追加
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc