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

注

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

サブスクリプション項目の請求期間を追加し、サブスクリプションの期間を削除しました破壊的変更

新規情報

Subscription Item (サブスクリプション項目) は、Subscription (サブスクリプション) リソースの最上位の共有請求期間ではなく、個別の請求期間を直接追跡するようになりました。

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

  • current_period_start フィールドと current_period_end フィールドは Subscription (サブスクリプション) リソースで使用できなくなりました。
  • customer.subscription.updated Webhook の previous_attributes に、サブスクリプション項目の請求期間の変更が表示されるようになりました。

影響

サブスクリプションの current_period_end フィールドと current_period_start フィールドを参照するコードを更新しました。代わりに、items.data.current_period_end フィールドと items.data.current_period_start フィールドを使用して、サブスクリプション項目の請求期間に直接アクセスするようになります。

システムが customer.subscription.updated Webhook の previous_attributes フィールドを正しく処理していることを確認します。たとえば、price や quantity が変更された場合は、previous_attributes.items.data[].price フィールドを調べる必要があります。

変更点

パラメーター変更するリソースまたは エンドポイント
current_period_endcurrent_period_start削除済み
Subscription
current_period_endcurrent_period_start追加済み
SubscriptionItem

アップグレード

  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