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

注

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

請求モードに改良後のクレジットの比例配分動作のサポートを追加公開プレビュー

新規情報

新しい billing_mode パラメーターを使用すると、Subscription (サブスクリプション)、Invoice Previewing (請求書プレビュー)、Checkout Sessions (Checkout セッション)、Subscription Schedule (サブスクリプションスケジュール) の作成時に、より柔軟な動作が可能になります。

billing_mode=classicbilling_mode=flexible
クレジットの比例配分は、サブスクリプション項目の_現在_の価格、税金、数量、および最後に使用された割引額に基づいて計算されます。これにより、顧客の税率がサイクルの途中で変更されたとき、引き落としの比例配分計算が無効になったとき、または複雑な割引クーポンが使用されたときに、予期しない比例配分が発生する可能性があります。クレジットの比例配分は、顧客に対して以前引き落としした元の金額に基づいて計算されます。これにより、税金、クーポン、請求サイクルを考慮した比例配分計算の精度が向上します。たとえば、クレジットの比例配分では、元の引き落とし額 (サイクルの途中で税率が変更された場合) に基づいて正確にクレジットが返金されるようになります。クレジットの日割り計算は、引き落としがなかった場合は行われません。
サブスクリプションのステータスが trialing に戻った場合、subscription.trial_start は変更されません。subscription.trial_start には、最新のトライアル開始日が反映されます。
以下が実行されている間、billing_cycle_anchor がリセットされることがあります。
  • cancel_at を次回のサブスクリプションサイクルより前の日付に設定すると、billing_cycle_anchor が cancel_at の日付にリセットされます。
  • 価格がすべて 0 USD のサブスクリプションから、価格が 0 USD を超えるサブスクリプションに切り替わると、billing_cycle_anchor は現在の時刻にリセットされます。
  • 継続期間が異なる料金に切り替わると、billing_cycle_anchor は現在の時刻にリセットされます。
以下が実行されている間でも、billing_cycle_anchor はリセットされません。
  • cancel_at を次回のサブスクリプションサイクルより前の日付に設定しても、billing_cycle_anchor は変わりません。
  • 価格がすべて 0 USD のサブスクリプションから、価格が 0 USD を超えるサブスクリプションに切り替わっても、billing_cycle_anchor は変わりません。
  • 継続期間が異なる料金に切り替わっても、billing_cycle_anchor は変わりません。

billing_mode を flexible に設定する場合、制限が適用されます。制限事項の詳細と、請求モードでサブスクリプションの動作を柔軟にする方法をご覧ください。

効果

サブスクリプションを作成する次の API メソッドで、billing_mode を flexible に設定します。

  • サブスクリプションを作成する
  • 請求書プレビューを作成する
  • Checkout セッションを作成する
  • サブスクリプションスケジュールを作成する

変化

パラメーター変更するリソースまたは エンドポイント
billing_mode追加済み
Checkout.Session#create.subscription_dataInvoice#create_preview.schedule_detailsInvoice#create_preview.subscription_details
 + さらに 7 件
Quote#create.subscription_dataQuote.subscription_dataQuotePreviewSubscriptionScheduleSubscription#createSubscriptionSchedule#createSubscriptionScheduleSubscription

アップグレード

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

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

このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc