Agent Skills
返回列表
💻

Stripe Connect 账户配置器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/stripe-connect-account-provisioner 到 AI 助手。

技能介绍

要解决的问题

接入 Stripe Connect 的团队通常需要为大量商户创建关联账户(connected account)。如果在控制台逐个手工创建、填写资料、上传 KYC 材料,流程不仅重复,还容易在几个关键环节出错:入驻链接漏发或过期、Webhook 签名没有校验、账户状态回写不及时,任何一种情况都会让上线流程卡住,排查时还得回到日志里逐条对账。

技能如何工作

该技能把这套流程收敛为一次 API 编排,核心分三步:

  • 创建关联账户:通过 Stripe API 提交账户创建请求,拿到 account_id 作为后续所有操作的锚点。
  • 生成 KYC 链接:调用 stripe.accountLinks.create() 生成一次性账户入驻链接,交由商户自助完成资料填写与证件上传。
  • Webhook 校验:对 account.updated 事件做签名验证,确认账户状态变更来自 Stripe 本身,而不是伪造或篡改的请求。

整体来看,技能负责把「建账户 → 分发链接 → 确认状态事件」串成一条可追踪的路径,业务侧只需要在事件到达后做自己的收尾处理。

适用边界与注意点

  • 依赖 Stripe Node.js 库,且必须配置账户的 secret key;密钥的存放与轮换属于使用方责任。
  • KYC 表单字段与审核策略由 Stripe 控制台和账户类型决定,技能不会绕过平台的合规校验,也不负责审批结果。
  • account.updated 只是状态变更信号,不等于入驻已完成;最终的放行逻辑仍要业务侧自行判断。
  • 上游文档会随 Stripe API 版本演进,具体行为以官方文档为准。

使用场景

  • 平台新增一批入驻商户,需要批量创建 Stripe Connect 关联账户并分发各自的 KYC 链接。
  • 商户在入驻页提交资料后,服务端要通过 Webhook 确认 account.updated 事件,避免误判账户状态。
  • 接入方正在搭建自助入驻流程,希望用代码生成一次性 Stripe 账户链接,而不在控制台逐个操作。
  • 需要按 Stripe API 返回的 account_id 关联业务侧账号,并校验后续状态变更事件的来源。

适合人员

  • 正在实现 Stripe Connect 入驻流程的后端工程师,需要稳定调用账户与 accountLinks API。
  • 负责商户入驻自动化的支付集成工程师,关注 Webhook 签名校验与 account.updated 处理。
  • 为平台搭建自助开户功能的工程团队,希望减少控制台手工创建关联账户的成本。
  • 需要把 Stripe 账户状态同步到自有系统的开发者,依赖 Webhook 事件做状态收尾。