# 基于 Accounts v1 API 设计高级 Connect 集成 了解基于 Accounts v1 API 的 Connect 集成的其他配置组合。 > #### Accounts v2 API 集成 > > 本指南仅适用于仍在使用账户 API v1 版本的现有 Connect 平台用户。若您是 Connect 新用户，请直接使用账户 API v2 版本。关于如何通过账户 API v2 版本配置 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 子账户。使用 Connect 时，您可以为每个用户创建 Connect 子账户，在您的平台上接收资金。 #### Item 1 将 Connect 子账户发送到 Stripe 托管的入驻流程。Stripe 托管的入驻流程允许您将用户重定向到 Stripe，以在联合品牌界面中完成入驻流程。 ![Connect 入驻表单的截图](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) 最适合希望以最少的集成工作量快速启动的情况： - Connect 子账户离开您的网站并被重定向到 Stripe 以完成流程。 - 与 Stripe 进行品牌联合，定制选项受限制。 - Stripe 处理所有入驻流程逻辑。 - 自动支持 46+ 国家和 14 种语言。 #### Item 2 将具有有限 Stripe 品牌信息的高度主题化的入驻用户界面直接嵌入到您的应用。Connect 子账户用户无需离开您的应用程序即可与嵌入式组件交互。只需几行代码即可集成嵌入式入驻流程。 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. 最适合希望通过更加集成的体验和较低的集成工作量将用户留在网站上的情况： - Connect 子账户会留在您的网站上。 - 高度主题化。限于无 Stripe 品牌。 - Stripe 处理所有入驻流程逻辑。 - 自动支持 46+ 国家和 14 种语言。 #### Item 3 通过调用相应的 Stripe API 构建入驻流程的各个方面。您需要在集成中构建自定义逻辑来满足要求的所有验证信息。 > #### Stripe 推荐 > > 构建和维护 API 入驻流程需要大量资源，并且需要定期更新。如果您希望实施自定义的入驻流程，Stripe 强烈建议您使用[嵌入式入驻](https://docs.stripe.com/connect/embedded-onboarding.md)。 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [入驻新的 Connect 子账户] --> [显示用户界面以从您的 Connect 子账户收集 requirements] [显示用户界面以从您的 Connect 子账户收集 requirements] --> [创建关联账户] [创建关联账户] --> [如果 requirements.currently_due 不为空] [检索关联账户] --> [如果 requirements.currently_due 不为空] [出示表单以收集信息并验证字段] --> [用收集的信息更新 Connect 子账户] [重新入驻现有的 Connect 子账户] --> [检索关联账户] [用收集的信息更新 Connect 子账户] --> [如果 requirements.currently_due 不为空] [如果 requirements.currently_due 不为空] --> [出示表单以收集信息并验证字段] ``` 最适合您希望完全控制入驻流程的情况： - 自行构建并维护所有的入驻流程逻辑。可能会消耗资源，且构建成本高昂。 - 您管理风险，完全承担 Connect 子账户的负余额。 - 您必须随验证要求的变化更新您的流程，并且还要构建额外的流程来传达和收集要求的此类信息。至少每六个月审核并更新一次入驻要求，确保您的流程中构建的是最新的要求。 - 您必须构建一个自定义表单来收集银行账户或借记卡信息，以便 Connect 子账户可以设置一个提现账户。 ### 设置管理平台流程 Connect 子账户需要访问管理平台来管理其账户。为 Connect 子账户提供权限，使其能够访问 Stripe 管理平台、Express 管理平台或使用 Stripe API 和嵌入式组件构建的管理平台。 #### Item 1 为 Connect 子账户提供 Stripe 管理平台的访问权限。 Stripe 管理平台允许 Connect 子账户使用自己的登录凭据，无限制地访问 Stripe 的全部功能。Connect 子账户可以随时直接登录 dashboard.stripe.com。他们可以使用 Stripe 支持服务，并且 Stripe 也可以就其账户与他们进行沟通。 当您的 Connect 子账户有以下需求时，请使用 Stripe 管理平台： - 需要管理其 API 密钥、Webhook 或开发者集成。 - 需要详细的财务报告或数据导出。 - 拥有不同访问权限需求的团队（例如，管理员和分析师等不同角色）。 - 使用 Stripe Apps。 您始终可以在自己的网站上添加[嵌入式组件](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)，同时提供对 Stripe 管理平台的访问权限。 #### Item 2 为 Connect 子账户提供 Express 账户管理平台访问权限，以便其管理自己的账户。 Express 账户管理平台是一个功能受限、由 Stripe 托管的管理平台，您可以通过品牌定制以及配置其支持的功能进行个性化设置。使用 Express 管理平台的 Connect 子账户可以获得 Stripe 支持服务，并且 Stripe 也可以就其账户与他们进行沟通。 当您的 Connect 子账户有以下需求时，请使用 Express 账户管理平台： - 主要需要跟踪其提现和支付活动。 - 不需要开发者工具或高级报表功能。 - 可以使用简洁、精简的用户界面。 您可以[配置 Express 账户管理平台](https://docs.stripe.com/connect/customize-express-dashboard.md#customize-features)，以定制您的 Connect 子账户可以访问哪些功能（如争议、退款和手动提现）。Connect 子账户通过您生成的[登录链接](https://docs.stripe.com/api/accounts/login_link/create.md)访问 Express 账户管理平台，而不是直接登录 dashboard.stripe.com。 在提供 Express 账户管理平台访问权限的同时，您随时可以将 [Connect 嵌入式组件](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)嵌入到您自己的网站中。 #### Item 3 用 Stripe API 或嵌入式组件创建管理平台，让 Connect 子账户能够管理他们的账户。 Connect 子账户不能访问 Stripe 管理平台或 Express 管理平台。您可以通过构建您的用户的管理平台、退款、争议工作流程和报告功能来提供对这些工作流程的访问权限。您的用户可能未意识到他们在您的平台上拥有 Stripe 账户。 建议集成 [Connect 嵌入式组件](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)，以低集成成本为您的平台应用添加管理平台功能。嵌入式组件支持丰富的主题配置选项，可以支持连接的账户，具有以下功能： - 支付工作流程，例如查看付款和提现、管理退款和回应争议 - 提现工作流程，例如管理提现计划、创建手动提现或更新提现账户 - 下载并导出付款与提现的报告工作流程 - 账户管理工作流程，例如更新商家信息 > 对于没有 Stripe 托管管理平台访问权限且 Stripe 对负余额负责的账户，请使用 Connect 嵌入式组件实现自助账户更新。您无法为此类账户创建类型为 `account_update` 的[账户链接](https://docs.stripe.com/api/account_links.md)。 > #### 管理平台类型不可更改 > > 您在创建 Connect 子账户时指定的管理平台将是永久性的，因此在决定管理平台类型时，请考虑您的长期业务需求。如需更改 Connect 子账户的管理平台，您必须创建一个新的 `Account` 对象。 ### 收款 您代您的 Connect 子账户创建一笔收款来向客户收款。您创建的收款类型： - 确定如何在有关各方之间分配支付资金 - 影响收款在客户的银行或对账单上的显示方式（有您的平台的信息或您的用户的信息） - 确定 Stripe 向哪个账户扣取退款和撤单费用 #### Item 1 直接收款是客户直接向 Connect 子账户进行的付款。客户直接与您的 Connect 子账户进行交易，通常不知道您的平台的存在。 该收款类型最适合提供软件即服务的平台。例如，Shopify 提供网店构建工具，而 Thoughific 则使教育工作者能够销售在线课程。 #### Item 2 在您的平台上创建定向收款并立即将资金转到 Connect 子账户。客户在您的平台上交易您的 Connect 子账户提供的产品或服务。 这种收款方式最适合像 Airbnb 这样的租赁市场或 Airbnb 这样的租车应用等交易市场。 定向收款是在平台上创建的，但作为收款操作的一部分，资金会立即转到您指定的 Connect 子账户。您可以决定是转移部分资金还是或全部资金。 除非您符合 [Connect 跨境打款](https://docs.stripe.com/connect/connect-cross-border-payouts.md)的条件，否则您的平台和您向其转账的 Connect 子账户必须位于同一地区，才能创建定向收款。如果尝试向不支持跨境的地区转账，系统将返回错误。 #### Item 3 创建独立收款和转账，将来自一笔付款的资金转到多个 Connect 子账户，或者在收款时不知道具体用户的情况下也可以采用这种方式。您的平台账户上的收款与向您的 Connect 子账户的转账无关。 这种收款类型最适合需要在多方之间分割付款的交易市场，如餐馆外卖平台 DoorDash。 虽然独立收款和转账提供了很大的灵活性，但它们需要更复杂的集成来管理您的平台和用户之间的账户余额。您必须仔细监测您的平台的账户余额，确保有足够的可用资金来支付转账金额。 除非您符合 [Connect 跨境打款](https://docs.stripe.com/connect/connect-cross-border-payouts.md)的条件，否则您的平台和您向其转账的 Connect 子账户必须位于同一地区，才能使用独立收款和转账。如果尝试向不支持跨境的地区转账，系统将返回错误。 ### Stripe 费用 #### Item 1 Stripe 向您的平台账户收取 Stripe 费用，包括平台费。向 Connect 子账户收取的平台费金额由您控制。用平台费参数向您的 Connect 子账户收取平台费。 #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- 直接收款 --> [10 美元收款] [10 美元收款] --> [0.59 美元平台费] [10 美元收款] -- 净额 9.41 美元 --> [bank] [0.59 美元平台费] -- （0.23 美元）Stripe --> [stripe] [0.59 美元平台费] -- 0.36 美元净额 --> [bank] [account] [platform] ``` #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [10 美元收款] [10 美元收款] --> [10 美元转账] [10 美元转账] --> [10 美元付款] [10 美元付款] --> [（1.23 美元）平台费] [（1.23 美元）平台费] --> [净额 8.77 美元] [（1.23 美元）平台费] --> [1.23 美元平台费] [1.23 美元平台费] --> [（0.59 美元）Stripe 费用] [（0.59 美元）Stripe 费用] --> [stripe] [（0.59 美元）Stripe 费用] --> [净额 0.64 美元] [platform] [account] ``` #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [100 美元收款] [100 美元收款] --> [（70 美元）转账] [（70 美元）转账] --> [70 美元付款] [（70 美元）转账] --> [（20 美元）转账] [（20 美元）转账] --> [20 美元付款] [（20 美元）转账] --> [（3.20 美元）Stripe 费用] [（3.20 美元）Stripe 费用] --> [stripe] [（3.20 美元）Stripe 费用] --> [净额 6.80 美元] [platform] [account] [account] ``` #### Item 2 Stripe 直接从您的 Connect 子账户收取 Stripe 费用。您可以在创建直接收款时收取可选的平台费。 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- 直接收款 --> [10 美元收款] [10 美元收款] --> [（1.23 美元）平台费] [（1.23 美元）平台费] --> [1.23 美元平台费] [1.23 美元平台费] --> [platform] [（1.23 美元）平台费] --> [（0.59 美元）Stripe 费用] [（1.23 美元）平台费] --> [净额 8.18 美元] [（0.59 美元）Stripe 费用] --> [stripe] [account] ``` ### 给用户打款 当支付的资金结算完毕并且您的用户的 Connect 子账户中有正的 Stripe 余额时，您即可将这些资金打到他们的外部账户。 #### Item 1 如果您使用 Stripe API 在您自己的流程中入驻用户，则还必须收集银行账户或借记卡信息，才能设置为 Connect 子账户设置提现账户。收集了提现账户的用户信息后，请将其关联为外部账户。如果您的 Connect 子账户没有验证的外部账户，则提现会被阻止。 #### Item 2 #### Item 3 默认情况下，Stripe 会每天滚动地提取您的 Connect 子账户余额中已结算的资金。如果愿意，您可以配置不同的自动提现计划，手动而非自动触发提现，或即时提现。 ### 负余额责任 #### Item 1 您的平台承担由您的 Connect 子账户的负余额带来的损失。您的平台负责在入驻过程中审查新的 Connect 子账户并确定用户的风险状况。 推荐用于从客户处收款并向卖方打款的交易市场，或希望对 Connect 子账户的风险及负面负债的管理方式进行全面管控的高级平台： - 您的平台必须监控 Connect 子账户的持续损失风险。 - 当您检测到欺诈或风险时，您的平台必须构建流程来与 Connect 子账户进行沟通并补救。 - 您拥有建立管理持续损失风险和防止欺诈流程的运营团队和工程资源。 在使用此设置创建账户之前，请仔细考虑并确认您已确认由您的平台承担负余额。 #### Item 2 Stripe 监控 Connect 子账户的风险信号，根据观察到的信号对 Connect 子账户实施风险干预，并寻求从您的 Connect 子账户中追回负余额。 对于大多数软件即服务平台来说，这是最佳的默认选择，对于那些刚刚接触嵌入式支付的平台尤其如此： - Stripe 监控您的 Connect 子账户的信用和欺诈风险，并在业务风险导致负余额的情况下防范损失风险。 - Stripe 通过托管流程或嵌入式组件直接与您的 Connect 子账户处理所有端到端通信和补救方案。 #### Item 1 > #### Express 账户管理平台所需的预览 API 版本 > > 将 Express 账户管理平台访问权限与 Stripe 承担负余额责任相结合的功能目前处于[公开预览](https://docs.stripe.com/release-phases.md)阶段。在创建 Connect 子账户时，请在您的 Stripe SDK 配置中使用当前的预览版本字符串 (`2026-10-28.preview`)。 > > 本页生成的代码和提示使用当前正式发布的 API 版本。如果您使用此组合，请将该版本替换为预览版本字符串。 #### Item 2 #### Item 3 #### Item 1 #### 必需的嵌入式组件 当 Stripe 负责您的 Connect 子账户的负余额时，您必须集成用于入驻、账户管理和通知横幅的嵌入式组件。 Stripe 用嵌入式通知横幅组件来通知 Connect 子账户有未满足的要求或其他与管理风险相关的请求。必须要提供账户管理组件，这样您的 Connect 子账户才能管理他们的验证证书和商家信息。 Stripe 还会代您给您的 Connect 子账户发送邮件，以管理风险并确认其持续合规。您可以用您自己的邮箱域名和平台品牌对这些邮件通讯信息进行自定义和品牌化。 对于任何其他可选组件，您也可以使用[嵌入式组件](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)或构建自己的 UI。 #### Item 2 #### Item 3 ## 适合您所做选择的集成步骤 以下集成步骤基于您在上面所做的选择。您可以通过在步骤右侧的面板上方或在该面板中选择不同选项来查看不同的步骤。此页面上的选项仅控制下面显示的步骤。它们不会影响您的平台配置。 以下按钮根据您的选择生成 LLM 提示。它仅支持 Stripe 托管管理平台和托管入驻。