コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
バージョン管理
API バージョンのアップグレード
Essentials
ツール
Visual Studio Code をご利用の場合
機能
Stripe 健全性アラートファイルのアップロード
AI ソリューション
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
Stripebot ウェブクローラー
Stripe を拡張する
パートナー
パートナー認定

メモ

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

プラットフォーム手数料オブジェクトに売上処理タイプを追加

新機能

Application Fee オブジェクトに settlement_type を追加します。このプロパティは手数料がネットベースまたはグロスベースのどちらで決済されるかを表します。

settlement_type プロパティには、次の値を指定できます。

  • net_settled: 手数料は請求時に精算される
  • gross_settled: 手数料は請求サイクルの終了時に精算される

以前は手数料の精算方法をプログラムで判断できず、支払いの照合と正確な精算額の把握が困難でした。

影響

settlement_type プロパティを使用して、次のことが実行できるようになりました。

  • 異なる精算方式の判別
  • プラットフォームに関するより正確な財務レポートの作成

精算額の算出を外部ロジックに依存されている場合、今後はこのプロパティを利用することで API レスポンスから直接精算方式を取得できるようになります。

変更点

パラメーター変更するリソースまたは エンドポイント
settlement_type追加済み
ApplicationFee

アップグレード

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

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