Treasury で連結アカウントを使用する

To use Financial Accounts for platforms, your platform must have a Stripe Connect integration. Stripe Connect enables a platform to provide connected accounts to sellers and service providers. For an overview of how connected accounts fit into the Financial Accounts for platforms account structure, see the Financial Accounts for platforms accounts structure guide.

Financial Accounts for platforms only supports connected accounts that don’t use a Stripe-hosted dashboard and where your platform is responsible for requirements collection and loss liability, including Custom connected accounts. Learn how to create connected accounts that work with Financial Accounts for platforms.

As a platform with connected accounts, you’re responsible for maintaining a minimum API version, communicating terms of service updates to your connected accounts, handling information requests from them, and providing them with support. Because your platform is ultimately responsible for the losses your connected accounts incur, you’re also responsible for vetting them for fraud. To learn more, read the Financial Accounts for platforms fraud guide.

Connected accounts require specific capabilities enabled on the account to use features of Financial Accounts for platforms. Different features require different capabilities, which might require additional information about your connected account owners. The treasury capability, for example, is a requirement on connected accounts for Financial Accounts for platforms access. When you request treasury for an account, additional fields become required for that connected account before the account can use Financial Accounts for platforms.

Before you create connected accounts in live mode for your Financial Accounts for platforms integration, we recommend you first create test connected accounts in a sandbox environment. Test connected accounts can’t receive or send real money and can’t be used in live mode, but are otherwise identical in configuration and functionality.

現在の連結アカウントのタイプを確認する

プラットフォームですでに連結アカウントの Connect 組み込みがあり、しかしそのタイプが分からない場合には、ダッシュボードや API を使用してこの情報を取得できます。

treasury ケイパビリティを持つ新しい連結アカウントを作成する

Use POST /v1/accounts to create a new connected account. Request the following capabilities for the account, which are required to use Financial Accounts for platforms:

• transfers (すべての連結アカウントに必要)
• treasury

If you want to issue cards with Stripe Issuing to your connected account, you must request the card_issuing capability, as well. See the Working with Stripe Issuing cards guide for more information.

ACH を使用して外部アカウントとの間での資金を移動する必要がある場合には、us_bank_account_ach_payments ケイパビリティもリクエストする必要があります。

前のオプションのすべてが含まれたリクエストは以下のようになります。

const account = await stripe.accounts.create({
  country: 'US',
  email: email,
  capabilities: {
    transfers: {requested: true},
    treasury: {requested: true},
    card_issuing: {requested: true},
  },
  controller: {
    dashboard: {type: "none"},
    losses: {payments: "application"},
    requirement_collection: "application",
    fees: {payer: "application"}
  },
});

成功すると、受信されるレスポンスで、連結アカウントとリクエストされた capabilities が確認されます。

{
  "id": "acct_1234",
  "object": "account",
  "capabilities": {
    "card_issuing": "inactive", // Should be requested only for Stripe Issuing users.
    "treasury": "inactive",
    "us_bank_account_ach_payments": "inactive"
  },
  ...
}

連結アカウントのケイパビリティの詳細については、Connect 用のアカウントのケイパビリティガイドをご覧ください。

連結アカウントを更新して treasury ケイパビリティを含める

すでに card_payments が有効になった連結アカウントがある場合には、POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} を使用して、関連付けられた ID のアカウントを treasury ケイパビリティのリクエストで更新します。以下のリクエストは、連結アカウントを treasury ケイパビリティのリクエストで更新します。また、このリクエストにはオプションの card_issuing と us_bank_account_ach_payments のケイパビリティが含まれています。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[us_bank_account_ach_payments][requested]"=true

Use POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} to update connected account capabilities for connected accounts that already have a FinancialAccount assigned. See Working with financial accounts or the FinancialAccount object API documentation for more information.

連結アカウントを登録する

アカウントを作成したら、そのアカウントに売り手やサービスプロバイダーをアカウント登録して所有者を設定する必要があります。連結アカウントを表す Account オブジェクトには、requirements ハッシュがあり、そこには currently_due の本人確認要件が含まれています。プラットフォームの売り手やサービスプロバイダーは、連結アカウントの支払いと入金を有効にし、金融口座でリクエストされたすべての機能を有効化するため、requirements ハッシュに項目化された詳細を提供する必要があります。

You have two options for onboarding connected account owners to Financial Accounts for platforms: hosted onboarding and custom onboarding. We recommend hosted onboarding.

テスト用の Account オブジェクトを作成し、アカウント登録要件をバイパスして機能をテストする場合は、POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} を使用して、すべての要件を満たすテスト値を指定します。次のリクエストでは、以前に作成した連結アカウントを使用して、必要なアカウントの詳細を適用します。

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "tos_acceptance[date]"=1547923073 \
  -d "tos_acceptance[ip]"="172.18.80.19" \
  -d "settings[treasury][tos_acceptance][date]"=1547923073 \
  -d "settings[treasury][tos_acceptance][ip]"="172.18.80.19" \
  -d "business_profile[mcc]"=5045 \
  --data-urlencode "business_profile[url]"="https://bestcookieco.com" \
  -d "company[address][city]"=Schenectady \
  -d "company[address][line1]"="123 State St" \
  -d "company[address][postal_code]"=12345 \
  -d "company[address][state]"=NY \
  -d "company[tax_id]"=000000000 \
  -d "company[name]"="The Best Cookie Co" \
  -d "company[phone]"=8888675309 \
  -d "individual[first_name]"=Jenny \
  -d "individual[last_name]"=Rosen

オンラインのアカウント登録を使用する

Use Connect Onboarding to efficiently collect required information. That offloads the verification complexity from your platform to Stripe and collects the terms of the service agreement. Alternatively, you can write your own API requests for initial integration, but must monitor for changes to compliance requirements to keep your onboarding workflow current. Learn how to create connected accounts that work with Financial Accounts for platforms.

Connect アカウント登録を使用する前に、Connect の設定ページのBrandingセクションで、ブランドの名前、色、アイコンを設定する必要があります。こうすることで、売り手やサービスプロバイダーがプラットフォームにアカウント登録する際に使用するフォームの視覚的外観をカスタマイズできます。

Connect アカウント登録のメリットを活用するには、POST /v1/account_links を使用して AccountLink を作成し、連結アカウントの所有権を取得する売り手またはサービスプロバイダーに提供します。

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

受信されるレスポンスには、ユーザーに提供する URL が含まれます。

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/iCtLfmYb2tEU"
}

埋め込み型アカウント登録を使用する

埋め込み型アカウント登録は、テーマを適用できるアカウント登録 UI であり、Stripe のブランディングは限定的にしか表示されません。Stripe 上のオンラインアカウント登録ソリューションよりも、きめ細かくユーザー体験をコントロールできます。埋め込み型アカウント登録を使用すると、カスタマイズされたアカウント登録フローを利用できます。規制要件の変更に応じた、アカウント登録システムの更新に関連する、複雑な作業やメンテナンスは不要です。

プラットフォームがアプリケーションにアカウント登録コンポーネントを埋め込むと、連結アカウントはアプリケーションを離れることなく埋め込みコンポーネントを操作できます。埋め込みアカウント登録では、Accounts API を使用して要件を読み取り、Stripe がサポートするすべての国に合わせて調整された、堅牢なデータ検証機能を持つアカウント登録フォームを生成します。

カスタマイズしたアカウント登録を使用する

ユーザー向けにカスタムのアカウント登録を構築する場合は、POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} と POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} を使用し、該当する Account オブジェクトと Person オブジェクトを必要な情報で更新します。

You must also confirm that the connected account owner has read and agreed to the Financial Accounts for platforms Agreement. See Handling verification with the API for additional details on fulfilling onboarding requirements.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "company[name]"=Homebox \
  -d "company[address][line1]"="123 Market St." \
  -d "company[address][city]"="San Francisco" \
  -d "company[address][state]"=CA \
  -d "company[address][postal_code]"=94107 \
  -d "company[address][country]"=US

要件

The fields in the following table are required for Financial Accounts for platforms users.

完了

連結アカウントのアカウント登録プロセスは、連結アカウントの以下のフィールドを確認する account.updated Webhook を受信すると完了します。

{
  "object": {
    "object": "account",
    "id": "acct_1234",
    "capabilities": {
      "treasury": "active",
      "card_issuing": "active", // Only appears if requesting the `card_issuing` capability.
      "us_bank_account_ach_payments": "active", // Only appears if requesting the `us_bank_account_ach_payments` capability.
    },
    ...
  }
}

プラットフォームの銀行パートナーが Evolve Bank & Trust の場合のアカウント登録の遅延は、5 分未満です。

要件の更新

To adapt to changes in financial regulations, Stripe must occasionally update information collection requirements for Financial Accounts for platforms. The requirements.eventually_due array on the Account object captures the updated information required by these regulation changes. Learn more about the requirements hash.