SuperAPI AI 工具集

stripe-integration

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:该技能面向使用 Stripe 完成支付集成的开发场景,服务端使用 Node.js SDK 处理 Payment Intent、订阅与 Webhook 校验,客户端使用 Stripe.js / React Stripe.js 组件收集支付信息。适用一次性支付、循环订阅、按用量计费、市场分账、托管结账页、自定义支付表单和 Webhook 驱动的履约流程;不适用于加密货币支付、Stripe 不可用地区,以及无需支付处理的简单静态商品销售。

主要能力:托管结账用 stripe.checkout.sessions.create(),支持 payment、subscription、setup 模式;服务端用 stripe.paymentIntents.create() 返回 client_secret 供客户端确认;客户端用 stripe.confirmPayment({ elements, clientSecret }) 确认支付。订阅通过 stripe.subscriptions.create() 创建,SCA 场景使用 payment_behavior: 'default_incomplete',更新时显式设置 proration_behavior,取消时可用 prorate: true 抵扣未用时长。客户门户用 stripe.billingPortal.sessions.create() 返回短期 URL。Webhook 用 stripe.webhooks.constructEvent() 校验,需原始请求体、签名头与端点密钥。React 侧用 <Elements stripe={stripePromise} options={options}> 包裹组件,<PaymentElement /> 自动渲染支持的支付方式。可用 expand 参数展开嵌套对象,用 stripe.paymentIntents.search({ query }) 过滤。

使用方式与限制:Webhook 校验前不要先解析 JSON,应使用 express.raw({ type: 'application/json' }) 传入原始体;不要在客户端创建 PaymentIntent,只传 client_secret;确认前先调用 elements.submit() 触发校验,并提供 return_url;密钥放环境变量并区分 sk_live_ 与 sk_test_;确认后检查 requires_action 状态处理 3D Secure;创建客户门户会话前需先在 Dashboard 保存设置;用 event.id 做 Webhook 幂等去重。资料未提供具体安装命令、价格与平台支持细节。