Accounts v2 への移行または Accounts v1 の復元公開プレビュー

Accounts v2 API を使用すると、Stripe で連結アカウントと顧客を単一のエンティティとして表すことができます。Accounts v2 では、Accounts v1 と Customers v1 の機能が 1 つの API にまとめられています。

Accounts v1 および Customers v1 から Accounts v2 への移行

既存のシステムで Accounts v1 または Customers v1 を使用している場合は、Accounts v2 API に移行して新しいアカウントを作成できます。これらのアカウントオブジェクトは、連結アカウントと顧客の両方を表します。

新しいアカウントと顧客に対して Accounts v2 を使用するようにシステムを更新するには、以下の手順に従います。

1. ダッシュボードの設定 > ベータプロダクトページで、Accounts v2 を有効にしてオプトインします。
2. 以下の Accounts v2 の動作を許可してください。
   • Accounts v1 API と Customers v1 API へのアクセスは保持され、既存の Accounts v1 オブジェクトと Customers v1 オブジェクトは有効化後も存続します。
   • ダッシュボード、Checkout、埋め込みアカウント登録、ホスティング登録などの Stripe インターフェイスでは、Accounts v1 オブジェクトまたは Customers v1 オブジェクトの代わりに、Accounts v2 オブジェクトがデフォルトで作成されます。
   • API ドキュメントは、デフォルトで Accounts v2 向けの内容になっています。Accounts v1 と Customers v1 のドキュメントには引き続きアクセスできます。
   • Treasury と Issuing は Accounts v2 オブジェクトをサポートしていません。Treasury と Issuing で Accounts v1 オブジェクトは引き続き使用できます。
3. Accounts v2 API を使用するようにシステムを更新します。Accounts v2 エンドポイントで Accounts v1 または Customers v1 のオブジェクトを参照することはできません。移行後に、以下のいずれかを実行する必要があります。
   • Accounts v2 オブジェクトを作成して、既存の Accounts v1 オブジェクトと Customers v1 オブジェクトを置き換えます。
   • 構築済みのシステムを更新して、Accounts v1 と Customer v1 のオブジェクトには API v1 エンドポイントを、Accounts v2 オブジェクトには API v2 エンドポイントを呼び出すように設定します。一部の API v1 エンドポイントでは Accounts v2 オブジェクトを参照できますが、顧客を表す Account を参照する場合は、customer パラメーターではなく customer_account パラメーターを使用します。

Accounts v2 から Accounts v1 および Customers v1 への移行

Accounts v2 の公開ベータをオプトアウトすると、Accounts v1 と Customers v1 の使用に戻ります。

新しいアカウントと顧客に対して Accounts v1 と Customers v1 を使用するようにシステムを更新するには、以下の手順に従います。

1. ダッシュボードの設定 > ベータプロダクトページで、Accounts v2 を無効にしてオプトアウトします。
2. 以下のオプトアウト操作を許可してください。
   • Accounts v2 API へのアクセスは保持され、既存の Accounts v2 オブジェクトはオプトアウト後も存続します。
   • ダッシュボード、Checkout、埋め込みアカウント登録、ホスティング登録などの Stripe インターフェイスでは、Accounts v2 オブジェクトの代わりに、Accounts v1 オブジェクトと Customers v1 オブジェクトがデフォルトで作成されます。
   • API ドキュメントは、デフォルトで Accounts v1 および Customers v1 向けの内容になっています。Accounts v2 のドキュメントには引き続きアクセスできます。
3. 連結アカウントには Accounts v1、顧客には Customers v1 を使用するようにシステムを更新してください。
   • Accounts v1 API では、Accounts v2 オブジェクトの acct_xxxxx ID を使用してアカウントを取得または更新できます。また、account パラメーターを使用して、アカウントを API v1 エンドポイントに渡すことも可能です。
   • Customers v1 API では、Accounts v2 オブジェクトの acct_xxxxx ID を使用して Customer v1 オブジェクトを取得・更新することはできません。ただし、customer_account パラメーターを使用して、オブジェクトを API v1 エンドポイントに渡すことは可能です。

プレビューに関する考慮事項

Accounts v2 では、支払いを直接回収するプラットフォーム上のビジネスごとに、設定可能な 1 つのアカウントを使用できます。プレビュー版リリースは、Treasury、Issuing、プレビュー段階の決済手段には対応していません。Accounts v1 では、Treasury、Issuing、プレビュー段階の決済手段を引き続き使用できます。

Connect プラットフォームの Accounts v2 はダッシュボードから有効にします。