SuperAPI AI 工具集

payment-integration

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

该技能面向支付集成场景,目标是以安全、可靠的方式完成支付处理,并特别关注 Stripe Connect 集市模式。

用途:在实现支付处理、结账流程、订阅与周期性扣款、支付 Webhook 事件处理时使用;适用于需要接入 Stripe、PayPal、Square 等处理器的项目。

主要能力:Stripe/PayPal/Square API 集成;结账流程与支付表单;订阅计费与周期性支付;支付事件 Webhook 处理(包含 Connect Webhook);PCI 合规与安全实践;支付错误处理与重试逻辑;Stripe Connect 的 Direct Charge、Destination Charge 与平台费用。

核心用法与模式:始终实现双重确认(Webhook 加前端校验),两者调用同一个幂等 confirmPayment() 函数;始终使用幂等操作,例如 UPDATE orders SET status = 'paid' WHERE id = ? AND status = 'pending',并检查影响行数为 0 时跳过副作用;库存或名额只在支付确认后以原子方式修改;使用官方 SDK,按需同时提供服务端与客户端代码,并包含实施前检查清单。

关键边界与坑点:使用 Direct Charge 时,结账会话创建在已连接账户上,Webhook 发往 Connect 端点而非平台端点;平台端点为 /webhooks/stripe,Connect 端点为 /webhooks/stripe/connect,后者必须包含 checkout.session.completed。100% 折扣码应判断 session.payment_status === 'paid' && session.amount_total === 0 && !session.payment_intent,而非依赖 no_payment_required。需处理浏览器关闭、网络失败、支付失败、争议、退款等异步与异常情况。

产出:带错误处理的支付集成代码、双 Webhook 端点、幂等支付确认逻辑、含索引的支付记录数据库结构、安全清单、测试支付场景与环境变量配置。

限制:未提供具体价格、平台支持范围、运行环境要求或安装命令;具体收益与效果暂未提供,需以官方 SDK 与文档为准。