SuperAPI AI 工具集

payment-processing

通用与其它

查看项目

更新于 10-16 05:07

技能介绍

用途:在实现支付流程时使用,面向 Stripe 或 Polar 的集成开发。覆盖结账集成、Webhook 处理、订阅管理和错误处理。

适用时机:实现结账流程、搭建 Stripe/Polar 集成、处理支付 Webhook、管理订阅、处理退款。

主要能力与关注点:结账(服务端创建会话、重定向处理);Webhook(签名验证、幂等、重试处理);订阅(生命周期事件、取消、升级);错误(优雅降级、用户提示、日志记录)。

必要用法:Stripe 使用服务端创建 Checkout Session(模式可为订阅或一次性支付),客户端拿到 URL 后重定向;Webhook 端点必须先验签(constructEvent),再按事件类型分发,如 checkout.session.completed、customer.subscription.created/updated/deleted、invoice.payment_failed,并在入库前做幂等检查。Polar 使用 @polar-sh/sdk 创建 checkout,并用 validateWebhookSignature 验签,处理 subscription.created 与 subscription.canceled 等事件。

安全与限制:Webhook 签名必须验证;密钥仅放环境变量;支付端点走 HTTPS;关键操作使用幂等键;客户端代码不含敏感数据;满足 PCI 合规;支付端点做限流。切勿记录完整卡号或 CVC,不在代码中存支付密钥,不跳过验签,不信任客户端支付数据,不在无幂等情况下处理支付。本地 Webhook 测试可用 Stripe CLI。

相关资料未提供收费、价格或平台支持范围的说明,暂未提供。