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

メモ

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

モバイル 決済 Element と 顧客 Sheet の 顧客 Sessions のサポートを追加

新機能

Payment Sheet と Payment Method Settings Sheet の Customer Session を作成できます。これを使用して顧客の決済手段を保存できます。

影響

これにより、Payment Sheet と Payment Method Settings Sheet で決済手段を保存する際に Customer Sessions をサポートできます。最新の機能を使用するには、既存の導入を customer ephemeral keys ではなく Customer Sessions を使用するように更新することをお勧めします。

たとえば、既存の導入で SetupIntents を使用して決済手段を保存し、今後の決済を設定している場合は、一時キー作成リクエストを置き換えます。

Command Line
curl https://api.stripe.com/v1/ephemeral_keys \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Version: 2026-01-28.clover" \
  -X "POST" \
  -d "customer"=
{{CUSTOMER_ID}}
 \

Customer Session の作成リクエストで置き換えます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customer_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "components[mobile_payment_element][enabled]"=true \
  -d "components[mobile_payment_element][features][payment_method_save]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_redisplay]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_remove]"=enabled

既存の導入で PaymentIntents を使用して決済中に決済詳細を保存している場合は、ガイドの例に従って同様の置き換えを行います。

変更点

パラメーター変更するリソースまたは エンドポイント
customer_sheetmobile_payment_element追加済み
CustomerSession#create.componentsCustomerSession.components

アップグレード

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

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