コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
概要
バージョン管理
変更ログ
    概要
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
開発者向けのツール
SDK
API
テスト
ワークベンチ
イベントの送信先
ワークフロー
Stripe CLI
Stripe Shell
開発者ダッシュボード
エージェントツールキット
LLM を使用した構築Visual Studio Code をご利用の場合Stripe 健全性アラートファイルのアップロード
セキュリティとプライバシー
セキュリティ
プライバシー
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

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

関連する変更点

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