アカウント v2 の相互運用性のために v1 の API に顧客アカウントプロパティを追加します

新機能

customer_account プロパティを追加し、Accounts v2 を使用するプラットフォームやマーケットプレイスが、連結アカウントや顧客から集めた決済を参照できるようにするものです。この特性は、例えば Payment Intents や Invoice など、複数の API v1 エンドポイントでご利用いただけます。

例えば、将来の決済のためにアカウントの決済情報を保存するには、Setup Intents API を使えます。この例では、口座は顧客として設定されています。

curl https://api.stripe.com/v1/setup_intents \
  -u "${API_KEY}" \
  -H "Stripe-Version: 2025-12-15.clover" \
  -d "payment_method_types[]=stripe_balance" \
  -d "payment_method_data[type]=stripe_balance" \
  -d confirm=true \
  -d customer_account=acct_1234 \
  -d usage=off_session

影響

Connect のプラットフォームやマーケットプレイスは、多くの場合、提供するサービスに対して連結アカウントに決済ます。以前は、Accounts v1 API と Customers v1 API を使用して、1 人のユーザーを表す 2 つのオブジェクトを作成していました。この分割表現では、KYC を 2 回収集し、2 つのオブジェクト間でデータを同期し、同じユーザーの複数の ID を保存する必要がありました。

Accounts v2 API を使用して、Stripe 全体でユーザーを表す単一の ID を作成できるようになりました。これにより、ユーザーの顧客と連結アカウントの ID 間で KYC を共有してアカウント登録コンバージョン率が向上するため、Connect ユーザーは重複した表現やカスタム関係ロジックを構築する必要がなくなります。

決済を徴収または追跡する API の customer_account プロパティでユーザーのアカウント ID を渡します。

もしあなたの統合が Customers v1 と customer プロパティを使っている場合、変更は不要です。新規または既存の連結アカウントで Accounts v2 API を使いたい場合は、ダッシュボードでご登録ください。

変更点

アップグレード