Stripe 支付连接器

要解决的问题

对接 Stripe 支付 API 时，开发者常面临几个工程层面的实际障碍：SDK 初始化配置分散、PaymentIntents / Customers / Subscriptions 三类资源的调用模式各不相同、Webhook 签名验证逻辑容易出错，以及涉及多方分账时 Stripe Connect 的接入门槛较高。这些工作需要统一的参考范式，才能避免每次从零翻阅文档。

核心能力

Stripe 支付连接器基于官方 stripe-node SDK，提供了以下核心能力：

• PaymentIntents 创建：通过 stripe.paymentIntents.create() 发起支付意图，覆盖单次收款的核心链路
• Customers 与 Subscriptions 管理：封装客户对象的增查操作，以及订阅的创建、查询与生命周期管理
• Webhook 事件处理：利用 stripe.webhooks.constructEvent() 完成签名验证与事件对象构造，确保回调数据的可信性
• Stripe Connect 支持：面向 Marketplace 场景，处理平台与子商户之间的分账支付

适用边界与注意点

• 该技能的内容提取自上游仓库文档，核心调用逻辑遵循 stripe-node 的官方 API 规范，实际使用时需以最新官方文档为准
• SDK 初始化需要配置账户的 Secret Key，密钥管理应在部署环境中遵循安全规范，不要硬编码
• 对于需要 Stripe Connect 完整 OAuth 授权流程的商户接入场景，需额外处理授权回调与账户状态校验
• Webhook 端点部署后需正确配置本地或服务端的环境变量，否则签名验证会失败

该技能适合作为 Stripe 集成项目的参考模板，帮助团队快速理解各类资源的调用方式与注意事项，但不替代对具体业务场景的适配工作。