Stripe Connect 集成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/stripe-connect-integration 到你的 AI 助手。
技能介绍
要解决的问题
做平台型业务时,你常需要让第三方合作方接入 Stripe 收款,这时就得处理 Stripe Connect 的账户入驻、带平台手续费的支付、以及 Connect 专属的 Webhook 事件。这些流程涉及多步 API 调用和签名校验,手动拼装容易出错,也难维护。
核心能力与工作方式
这个技能聚焦 Connect 集成里的三个关键环节:
- 账户入驻:通过
Account Links API生成入驻链接,把合作方引导到 Stripe 托管的 onboarding 页面,无需自己搭表单。 - 带手续费的支付:创建
PaymentIntents时嵌入application fees,让平台在每笔交易中抽取固定或比例费用。 - Connect Webhook:处理与 Connect 相关的事件(如账户状态变更、收款完成),保证平台侧逻辑与 Stripe 状态同步。
它基于 Stripe Node.js SDK(stripe@14.x)封装这些操作,你只需按步骤调用对应方法,不必关心底层请求细节。
适用边界与注意点
- 只覆盖 Stripe Connect 相关流程,不涉及常规支付或退款逻辑。
- 依赖
stripe@14.xSDK,需提前配置账户的 secret key。 - 处理 Webhook 时要做签名校验,否则可能被伪造请求命中。
使用场景
- 平台需要把合作商家拉进 Stripe Connect,用 Account Link 完成开户入驻。
- 平台要在用户支付时抽取手续费,创建带 application fees 的 PaymentIntent。
- 需要校验并处理 Connect 账户状态变更或收款完成的 Webhook,同步本地状态。
适合人员
- 平台后端工程师,需要在 Node.js 服务里接入 Stripe Connect 开户、扣费和 Webhook。
- 支付集成开发者,想用 stripe@14.x 统一封装 Connect 账户和 PaymentIntent 流程。
- 负责财务对账的开发者,需要把 Connect 收款与手续费流水接到内部系统。