コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
事業で活用する
カード即時通貨換算
プラットフォームに組み込む
プラットフォーム向け金融口座

連結アカウントの使用

treasury ケイパビリティをリクエストして、連結アカウントのオンボーディング要件を収集します。

プラットフォーム向け金融口座を使用するには、プラットフォームが Stripe Connect を導入している必要があります。Stripe Connect により、プラットフォームは売り手や代行業者に連結アカウントを提供できます。連結アカウントがプラットフォーム向け金融口座のアカウント構造にどのように適合するかの概要については、プラットフォーム向け金融口座のアカウント構造 ガイドをご覧ください。

Financial Accounts for platforms が対応するのは、Stripe がホストするダッシュボードを使用せず、Custom Connect アカウントを含め、プラットフォームが要件徴収と損失責任を負う連結アカウントのみです。プラットフォーム向け金融口座で動作する連結アカウント の作成方法については、こちらをご覧ください。

連結アカウントを持つプラットフォームとしては、最低 API バージョンを維持し、利用規約の更新を連結アカウントに伝え、連結アカウントからの情報リクエストに対応し、サポートを提供する責任があります。プラットフォームは、連結アカウントが被る損失の最終的な責任を負うため、不正利用がないかどうかを審査する責任もあります。詳細については、プラットフォーム向け金融口座不正利用ガイド をお読みください。

連結アカウントは、プラットフォーム向け金融口座の機能を使用するために、アカウント上で有効化された特定のケイパビリティを必要とします。異なる機能には異なるケイパビリティが必要であり、連結アカウントの所有者の追加情報が必要になる場合があります。例えば、treasury ケイパビリティは、プラットフォーム向け金融口座アクセスのために連結アカウントに必要です。アカウントに treasury をリクエストすると、そのアカウントがプラットフォーム向け金融口座を使用する前に、その連結アカウントに追加のフィールドが要求されます。

プラットフォーム向け金融口座の導入のために本番環境で連結アカウントを作成する前に、まず サンドボックス 環境でテスト連結アカウントを作成することをお勧めします。テスト用連結アカウントは実際の資金を送受信できず、本番環境では使用できませんが、その他の構成や機能は同じです。

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

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

ダッシュボードの連結アカウントのページに移動します。連結アカウントが表形式で一覧表示されます。

アカウントの機能を見つけるには、表でアカウントを選択して詳細ビューを開き、プロフィール > アカウント情報 をクリックします。

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

メモ

このガイドでは、プラットフォーム向け金融口座用の Stripe API を使用して新しい連結アカウントを作成する方法を説明しますが、網羅的ではありません。ホストされたアカウント登録を含む連結アカウント作成に関する完全なドキュメントは、Connect 導入ガイド をご覧ください。

POST /v1/accounts を使用して新しい連結アカウントを作成します。プラットフォーム向け金融口座を使用するために必要な、アカウントの以下のケイパビリティをリクエストします。

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

メモ

アカウントを作成する際にリクエストしない場合には、後でアカウントを更新してこれらのケイパビリティをリクエストできます。

Stripe Issuing でカードを連結アカウントに発行する場合は、card_issuing ケイパビリティもリクエストする必要があります。詳しくは、Stripe Issuing カードの使用 ガイドをご覧ください。

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 のケイパビリティが含まれています。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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

FinancialAccount が既に割り当てられている連結アカウントのケイパビリティを更新するには、POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} を使用してください。金融口座の使用 または FinancialAccount オブジェクト の API ドキュメントを参照してください。

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

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

プラットフォーム向け金融口座への連結アカウント所有者のアカウント登録には、ホストされたアカウント登録 と カスタムアカウント登録 の 2 つのオプションがあります。Stripe はホストされたアカウント登録をお勧めします。

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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

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

Connect Onboarding を使用して、必要な情報を効率的に収集します。これにより、確認の複雑さをお客様のプラットフォームから Stripe にオフロードし、利用規約を収集します。または、独自の API リクエストを作成して初期導入することもできますが、アカウント登録ワークフローを最新の状態に保つため、法令遵守要件の変更を監視する必要があります。プラットフォーム向け金融口座と連携する連結アカウント の作成方法については、こちらをご覧ください。

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

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

警告

セキュリティ上の理由から、アカウントリンクの URL をメールやテキスト、またはその他の方法でユーザーに直接送信しないでください。代わりに、プラットフォームのアプリケーション内から認証済みユーザーをアカウントリンクの URL にリダイレクトします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 オブジェクトを必要な情報で更新します。

また、連結アカウントの所有者が Financial Accounts for platforms Agreement を読み、同意していることを確認する必要があります。アカウント登録要件を満たすための詳細については、Handling verification with the API を参照してください。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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

要件

以下の表のフィールドは、プラットフォーム向け金融口座のユーザーには必須です。

法人タイプアカウント登録時
個人、個人事業主法人の詳細:
  • ビジネス名 (顧客に表示される正式名称)
  • 法人タイプ
  • ビジネスの所在地
  • ビジネスの電話番号
  • 商品またはサービスの説明
  • 業種または加盟店カテゴリーコード
  • 納税者番号 (SSN、ITIN、または EIN）
  • プラットフォーム向け金融口座の TOS 受け入れ
  • Stripe 利用規約への同意
所有者の詳細:
  • 法人名
  • 生年月日
  • メールアドレス
  • 現住所
  • 完全な SSN、またはアメリカ以外の人の場合や SSN を確認できない場合には身分証明書を直接撮影した画像ファイル
  • 役職
  • 電話番号
会社 (LLC、企業、非営利団体、共同事業など)法人の詳細:
  • ビジネス名 (顧客に表示される正式名称)
  • 法人タイプ
  • ビジネスの所在地
  • ビジネスの電話番号
  • 商品またはサービスの説明
  • 業種または加盟店カテゴリーコード
  • 納税者番号 (EIN)
  • プラットフォーム向け金融口座の TOS 受け入れ
  • Stripe 利用規約への同意
オーナー/代表者の詳細:
  • 法人名
  • 生年月日
  • メールアドレス
  • 現住所
  • 電話番号
  • 役職
  • 会社の所有率
  • 完全な SSN、またはアメリカ以外の人の場合や SSN を確認できない場合には身分証明書を直接撮影した画像ファイル

完了

連結アカウントのアカウント登録プロセスは、連結アカウントの以下のフィールドを確認する 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 分未満です。

要件の更新

金融規制の変更に適応するため、Stripe はプラットフォーム向け金融口座の情報収集要件を更新する必要があります。Account オブジェクトの requirements.eventually_due 配列は、このような規制の変更によって要求される更新情報をキャプチャーします。requirements ハッシュの詳細については、こちらをご覧ください。