Accounts v1 と Accounts v2 の SaaS プラットフォーム構成の比較公開プレビュー

Connect 利用している SaaS (サービスとしてのソフトウェア) プラットフォームは、多くの場合、プラットフォームサービスを提供するためにサブスクリプション料金を請求します。Accounts v1 では、1 つの会社がサブスクリプションの支払い (Customer として) とプラットフォーム上での運営 (Account として) の両方を行えるように、プラットフォームが個別の Stripe オブジェクトを維持する必要があります。Accounts v2 では、連結アカウントとのすべてのやり取りを 1 つのマルチ設定オブジェクトで管理できます。

Accounts v2 API

API v2 では、Account オブジェクトは複数の設定を持つことができます。設定ごとに異なるタイプのビジネス関係が表示され、さまざまな Stripe 製品を使用できるようになります。複数の設定を Account に割り当てることで、SaaS プラットフォームは Customer を作成することなく、Connect と Billing の両方を使用できるようになります。

Accounts v2 API で以下のことが可能になります。

• 全体像の描写: 1 つの Account オブジェクトで、連結アカウントとプラットフォームの間の複数の関係を表すことができます。
• 柔軟な設定: Account に割り当てられた設定を変更して、Stripe の商品と機能を有効化または変更します。
• ID データの一元化: Account オブジェクトは、連結アカウントのすべての ID データを保存します。既存の Account に設定を追加する場合、既に提供されている要件を収集する必要はありません。

Stripe のドキュメントを参照するときは、API v2 の Account と API v1 の Account の構造の違いに注意してください。以下に例を挙げます。

• Accounts v2 では、一部のプロパティは Account の configuration または identity プロパティに含まれています。
• API v2 の Accounts は、card_payments や stripe_balance.stripe_transfers などの機能を、設定タイプに関連付けます。
• API v2 では、各要件に固有の status プロパティがあります。API v1 では、Accountには各要件ステータスの配列が含まれており、要件はステータスに応じてそれらの配列に表示されます。

次の表は、一部の Accounts v1 プロパティと Accounts v2 プロパティがどのように対応しているのか示しています。

API v1 でアカウントと顧客を指定して Connect と Billing を使用する

API v1 では、Account オブジェクトは Connect の機能のみをサポートします。連結アカウントにサブスクリプションの請求を行うには、同じ連結アカウントであることを示す Customer オブジェクトをプラットフォームで作成する必要があります。Accounts v1 と Customers v1 は明示的な関係性を持たないため、プラットフォームはこれらのオブジェクトを別々に管理し、Account ID と Customer ID を継続してマッピングする必要があります。

API v1 における SaaS プラットフォームとアカウントおよび顧客の関係

API v2 でアカウントを指定して Connect と Billing を使用する

Accounts v2 では、支払いを回収し、サブスクリプション手数料を支払う連結アカウントは、Account オブジェクトと Customer オブジェクトの両方を必要としません。代わりに、Account に該当する設定を割り当てることでその情報を表すことができます。

連結アカウントが顧客から支払いを回収できるようにするには、加盟店の設定を対応する Account に割り当てます。

プラットフォームと加盟店が設定されているアカウント

プラットフォームが連結アカウントから支払い (サブスクリプションの支払いを含む) を回収できるようにするには、顧客の設定を Account に追加します。

プラットフォームと加盟店および顧客が設定されているアカウント

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

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

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