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

SaaS プラットフォームが Accounts v2 を使用して Stripe Billingで連結アカウントに請求する方法をご紹介します。

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 プロパティがどのように対応しているのか示しています。

Accounts v1 プロパティ	Accounts v2 プロパティ
business_profile.url	identity.business_details.url
business_profile.support_url	configuration.merchant.support.url
business_profile.product_description	identity.business_details.product_description
各要件は、そのステータスに応じて 1 つ以上の配列に出現します。 requirements.currently_due requirements.eventually_due requirements.past_due	1 つの配列にすべての要件が格納されています。要件のステータスを確認するには、`minimum_deadline.status` を調べます。個々の要件のステータス: requirements.entries.minimum_deadline.status 最も早い期日のステータス: requirements.summary.minimum_deadline.status

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 に追加します。

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

注

加盟店が設定されている Account からプラットフォーム手数料を回収できます。顧客の設定をアカウントに割り当てても、そのケイパビリティには影響しません。

Preview considerations

Accounts v2 allows you to use a single, configurable account for each business on your platform that collects payments directly. The preview release doesn’t support Treasury, Issuing, or payment methods that are in preview. You can still use Treasury, Issuing, or payment methods in preview with Accounts v1.

Enable Accounts v2 for your Connect platform from your Dashboard.