# Accounts v1 API を使用した高度な Connect 導入の設計 Accounts v1 API に基づく Connect 導入の代替構成の組み合わせについてご紹介します。 > #### Accounts v2 API 導入 > > このガイドは、Accounts v1 API を使用する既存の Connect プラットフォームにのみ該当します。新規の Connect ユーザーは、Accounts v2 API をご利用ください。Accounts v2 API を使用して Connect プラットフォームを設定する方法については、[インタラクティブ・プラットフォームガイド](https://docs.stripe.com/connect/interactive-platform-guide.md)をご覧ください。 このガイドを使用してさまざまな Connect の機能を確認し、独自の実装手順のリストを作成します。*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境で実装を開始する前に、[Stripe アカウントを作成するかログイン](https://dashboard.stripe.com)し、[プラットフォームを Connect にアカウント登録](https://dashboard.stripe.com/settings/connect/platform-profile)する必要があります。 ## プロパティを選択する ### アカウントを作成してアカウント登録を行う Stripe では、連結アカウントと呼ばれるアカウントをユーザーの代理で作成できます。Connect を使用する場合は、プラットフォームで資金を受け取る各ユーザーに連結アカウントを作成します。 #### Item 1 連結アカウントを、Stripe がオンラインで提供するアカウント登録フローに送信します。 Stripe がオンラインで提供するアカウント登録を使用すると、ユーザーを Stripe にリダイレクトし、共同ブランディングのインターフェイスで登録プロセスを完了できます。 ![Connect アカウント登録フォームのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) 最小限の実装作業ですぐに立ち上げたい場合に最適です。 - 連結アカウントはお客様のサイトを離れ、Stripe にリダイレクトされてフローを完了します。 - Stripe との共同ブランディングであり、カスタマイズできるオプションは限られています。 - Stripe がすべてのアカウント登録フローロジックを処理します。 - 46 カ国以上と 14 の言語に自動で対応します。 #### Item 2 Stripe ブランディングが一部に限定された、カスタマイズの自由度が高いアカウント登録 UI をアプリケーションに直接埋め込みます。連結アカウントのユーザーは、アプリケーションを離れずに埋め込みコンポーネントとやり取りできます。数行のコードで埋め込みアカウント登録を導入することができます。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. より統合された操作性を提供し、導入の負荷を軽減して、ユーザーをサイトに保持したい場合に最適です。 - 連結アカウントはお客様のサイトに留まります。 - カスタマイズの自由度が高くなります。Stripe ブランディングなしに限定されます。 - Stripe がすべてのアカウント登録フローロジックを処理します。 - 46 カ国以上と 14 の言語に自動で対応します。 #### Item 3 対応する Stripe API を呼び出して、アカウント登録フローの各側面を構築します。必要なすべての確認情報を満たすには、実装でカスタムロジックを構築する必要があります。 > #### Stripe の推奨事項 > > API によるアカウント登録フローを構築して維持するには大量のリソースと定期的な更新が必要です。カスタマイズしたアカウント登録フローを実装する場合は、[埋め込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)を利用することを強くお勧めします。 (See full diagram at https://docs.stripe.com/connect/design-an-integration) アカウント登録フローを完全にコントロールしたい場合に最適です。 - すべてのアカウント登録フローロジックを自分で構築、管理します。多大なリソースが必要で、構築に費用がかかります。 - 連結アカウントのマイナス残高についてはお客様が全責任を負い、リスクを管理します。 - 確認要件が変更されときにフローを最新状態に保つ必要があります。また、追加のフローを作成してこれらの要件をユーザーに伝え、ユーザーから要件を収集する必要があります。少なくとも 6 カ月ごとにアカウント登録要件を確認して更新し、最新の要件をフローに組み込むようにします。 - 連結アカウントに入金口座を設定できるように、銀行口座またはデビットカードを収集するカスタムフォームを作成する必要があります。 ### ダッシュボードフローを設定する 連結アカウントは、アカウントを管理するためにダッシュボードへのアクセス権が必要です。連結アカウントに Stripe ダッシュボード、Express ダッシュボード、または Stripe API と埋め込みコンポーネントを使用して構築したダッシュボードへのアクセス権を提供します。 #### Item 1 連結アカウントに Stripe ダッシュボードへのアクセス権を提供します。 Stripe ダッシュボードは、入金の表示、返金、不審請求の申請への対応、レポートへのアクセス、独自の支払いの処理など、すべての機能を連結アカウントに提供します。ユーザーは各自の Stripe ダッシュボードにいつでもサインインでき、Stripe に直接アクセスしてダッシュボードを利用できます。ユーザーは Stripe サポートを利用でき、Stripe はアカウントについて連絡したり、ユーザーとやり取りしたりできます。 Stripe ダッシュボードは以下の場合に使用します。 - ユーザーが強力な決済ワークフローと高度なユーザー管理機能を利用する必要がある。 - Stripe が連結アカウントの損失のリスクを管理し、マイナス残高の責任を負うようにしたい。 - Stripe ブランディングと限定的なプラットフォーム共同ブランディングが自社の要件に合っている。 [埋め込み型コンポーネント](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)は、Stripe ダッシュボードへのアクセス権を提供するとともに、いつでも独自のウェブサイトに追加できます。 #### Item 2 連結アカウントがアカウントを管理できるように Express ダッシュボードへのアクセス権を提供します。 Express ダッシュボードを使用すると、連結アカウントは利用可能な残高の表示、入金予定の確認、利益の追跡をリアルタイムで行うことができます。ユーザーは、Express ダッシュボードで返金や不審請求の申請を管理することはできません。ユーザーは Stripe サポートを利用でき、Stripe はアカウントについて連絡したり、ユーザーとやり取りしたりできます。 Express ダッシュボードは以下の場合に使用します。 - ユーザーが、ワークフローへの限定的なアクセスを必要とするマーケットプレイスの売り手である。 - 主にこれらのユーザーに入金する。ユーザーは、返金や不審請求の申請を直接管理しない。 - ダッシュボードの外観や使用感を完全にブランド化してみませんか。 - 連結アカウントのマイナス残高の責任を負い、損失のリスクを管理することが自社の要件に合っている。 Stripe ダッシュボードへのアクセスを提供するのと並行して、いつでも [Connect 組み込みコンポーネント](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)を自分のウェブサイトに追加できます。 #### Item 3 Stripe API または埋め込みコンポーネントを使用してダッシュボードを作成し、連結アカウントが各自のアカウントを管理できるようにします。 連結アカウントは、Stripe ダッシュボードや Express ダッシュボードにはアクセスできません。ユーザーのダッシュボード、返金、不審請求の申請ワークフロー、およびレポート機能を構築することにより、これらのワークフローへのアクセス権を提供するかどうかはお客様が決定します。ユーザーはお客様のプラットフォームで自分が Stripe アカウントを持っていることに気づかない場合があります。 [Connect 組み込みコンポーネント](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)を導入して、導入の手間を省きながらプラットフォームアプリケーションにダッシュボード機能を追加することをお勧めします。組み込みコンポーネントはテーマ設定が簡単で、次の連結アカウントをサポートできます。 - 支払いや入金の確認、返金の管理、不審請求の申請への対応などの支払いワークフロー - 入金スケジュールの管理、手動入金の作成、入金口座の更新などの入金ワークフロー - 支払いと入金をダウンロードしてエクスポートするレポート作成ワークフロー - 事業情報の更新などのアカウント管理ワークフロー > Stripe がホストするダッシュボードへのアクセス権がないアカウントで、Stripe がマイナスの残高に対して責任を負う場合は、Connect 組み込みコンポーネントを使用して、セルフサービスのアカウント更新を提供します。このようなアカウントに対してタイプ `account_update` の [アカウント Link](https://docs.stripe.com/api/account_links.md)を作成することはできません。 ### 決済を受け付ける 支払いを作成し、連結アカウントの代理として顧客からの支払いを受け付けます。作成する支払いのタイプを以下に示します。 - すべての関係者間での支払いの売上の分配方法を決定します - 顧客の銀行明細書または請求明細書で支払いが (プラットフォームまたはユーザーの情報と共に) どのように表示されるかに影響を与えます - 返金とチャージバックを Stripe が引き落とすアカウントを決定します #### Item 1 ダイレクト支払いとは、連結アカウントに対して直接行われる顧客の支払いです。顧客は連結アカウントと直接取引し、プラットフォームの存在に気付かないことがよくあります。 この支払いタイプは、SaaS (サービスとしてのソフトウェア) を提供するプラットフォームに最適です。たとえば、Shopify はオンラインストアフロントを構築するためのツールを提供し、Thinkific は教育者がオンラインコースを販売できるようにしています。 #### Item 2 プラットフォームでデスティネーション支払いを作成し、連結アカウントに売上を即時に送金します。顧客は、連結アカウントが提供する商品またはサービスについてプラットフォームと取引します。 この支払いタイプは、住宅賃貸マーケットプレイスの Airbnb や、ライドシェアアプリの Lyft などのマーケットプレイスに最適です。 デスティネーション支払いはプラットフォームで作成されますが、売上は支払い操作の一環として、指定した連結アカウントに即時に送金されます。その売上の一部または全額を送金するかどうかを決定できます。 [越境入金](https://docs.stripe.com/connect/cross-border-payouts.md)の対象となる場合を除き、デスティネーション支払いを作成するには、お客様のプラットフォームと、売上の送金先の連結アカウントが、同じ地域に所在する必要があります。許可されていない越境送金を試みると、エラーが返されます。 #### Item 3 支払いと送金別方式で作成して、1 つの支払いから複数の連結アカウントに資金を送金する場合や、支払い時に特定のユーザーが不明な場合に送金します。プラットフォームアカウントでの支払いは、連結アカウントへの送金から切り離されます。 この支払いタイプは、レストランのデリバリープラットフォームである DoorDash のように、複数の当事者間で支払いを分割する必要があるマーケットプレイスに最適です。 支払いと送金別方式は多くの柔軟性を提供しますが、プラットフォームとユーザーの間の口座残高を管理するには、より複雑な実装が必要になります。送金額に対応できるだけの十分な資金を保持するため、プラットフォームアカウントの残高を注意して監視する必要があります。 [越境入金](https://docs.stripe.com/connect/cross-border-payouts.md)の対象となる場合を除き、支払いと送金別方式を使用するには、お客様のプラットフォームと、売上の送金先の連結アカウントが、同じ地域に所在する必要があります。許可されていない越境送金を試みると、エラーが返されます。 ### Stripe 手数料 #### Item 1 Stripe は、処理手数料を含む Stripe 手数料をプラットフォームアカウントから徴収します。お客様は連結アカウントに請求する処理手数料の金額を管理します。プラットフォーム手数料パラメーターを使用して、連結アカウントから処理手数料を徴収します。 #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 2 Stripe は、連結アカウントから直接 Stripe 手数料を徴収します。ダイレクト支払いを作成する際に、オプションのプラットフォーム手数料を徴収できます。 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ### ユーザーに入金する 決済が完了し、ユーザーの連結アカウントの Stripe 残高がプラスになったら、その売上をユーザーの外部口座に入金できます。 #### Item 1 Stripe API を使用して独自のフローでユーザーをアカウント登録する場合も、銀行口座またはデビットカードを収集して、連結アカウントに入金口座を設定する必要があります。入金口座のユーザーの情報を収集したら、それを外部口座として関連付けます。連結アカウントに確認済みの外部口座がない場合、入金はブロックされます。 #### Item 2 #### Item 3 デフォルトでは、Stripe は連結アカウントの残高で売上処理された売上を毎日入金します。必要に応じて、さまざまな自動入金スケジュールを設定したり、自動ではなく手動で入金をトリガーしたり、即時に入金したりすることもできます。 ### マイナス残高に対する責任 #### Item 1 プラットフォームは、連結アカウントのマイナス残高によって発生する損失に対する責任を負います。プラットフォームには、アカウント登録時に新しい連結アカウントを審査し、ユーザーのリスクプロファイルを決定する責任があります。 売り手に入金するために買い手から支払いを回収するマーケットプレイスや、連結アカウントのリスクとマイナスの負債を完全にコントロールしたい高度なプラットフォームに推奨されます。以下に例を挙げます。 - プラットフォームは、継続的な損失のリスクがないか連結アカウントを監視する必要がある。 - プラットフォームは、不正利用やリスクが検出された場合に連結アカウントに連絡し、修正するためのフローを構築する必要がある。 - 運用チームとエンジニアリングリソースの両方が、継続的な損失のリスクを管理し、不正利用を防止するためのプロセスを構築する。 この設定でアカウントを作成する前に、マイナス残高に対するプラットフォームの責任を慎重に検討し、確認してください。 #### Item 2 Stripe は、連結アカウントのリスクシグナルを監視し、確認されたシグナルに対応して連結アカウントにリスクの介入を実施し、連結アカウントのマイナス残高の回復を求めます。 ほとんどのサービスとしてのソフトウェアプラットフォーム、特に支払いを埋め込むことに初めて対応するプラットフォームにとって、これは最適なデフォルトの選択です。 - Stripe は、ビジネスリスクに起因するマイナス残高による損失のリスクからの保護だけでなく、クレジットリスクと不正利用のリスクについて連結アカウントを監視します。 - Stripe は、オンラインフローまたは埋め込みコンポーネントを使用して、連結アカウントとのエンドツーエンドのやり取りと改善をすべて直接処理します。 #### Item 1 #### 必須の埋め込みコンポーネント Stripe が連結アカウントのマイナス残高の責任を負う場合、お客様はアカウント登録、アカウント管理、通知バナーの埋め込みコンポーネントを導入する必要があります。 Stripe は埋め込みの通知バナーコンポーネントを使用して、未対応の要件やその他の管理対象リスクに関連するリクエストを連結アカウントに通知します。アカウント管理コンポーネントは、連結アカウントが認証情報と事業情報を管理できるようにするために必要です。 また、Stripe は、リスクを管理して継続的な法令遵守を維持するために、お客様に代わって連結アカウントにメールを送信します。これらのメール通信は、独自のメールドメインとプラットフォームのブランディングを使用してカスタマイズし、ブランド設定できます。 その他のオプションコンポーネントについては、[埋め込み型コンポーネント](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)を使用するか、独自の UI を構築することもできます。 #### Item 2 #### Item 3 ## 選択した内容の実装手順 次の実装手順は、上記で選択したオプションに基づいています。上記、または手順右側のパネルのオプションを選択すると、対応する手順が表示されます。このページのオプションは、以下に表示される手順のみを制御します。プラットフォームの設定には影響しません。 以下のボタンは、あなたの選択に基づいて LLM 用のプロンプトを生成します。これは Stripe が提供するダッシュボードおよびホスト型ユーザー登録のみをサポートしています。