SuperAPI AI 工具集

payment-integration

编程与开发

查看项目

更新于 10-15 08:46

技能介绍

用途

该技能提供支付网关集成与 PCI 合规计费系统设计方面的专业能力,专注于实现结账流程、订阅管理和支付处理,支持 Stripe、PayPal、Adyen 等服务商。

适用场景

  • 集成 Stripe、PayPal 或其他支付网关
  • 实现结账与支付流程
  • 构建订阅计费系统
  • 确保 PCI-DSS 合规
  • 处理支付 Webhook
  • 实现支付重试逻辑
  • 设置多币种支付
  • 构建发票系统

不适用场景

  • 总账/会计系统 → 使用 /fintech-engineer
  • 非支付重点的 API 设计 → 使用 /api-designer
  • 仅前端结账 UI → 使用 /frontend-design
  • 安全审计 → 使用 /security-auditor

决策框架

按支付用例选择方案:

  • 一次性购买 → Stripe Checkout / PayPal Buttons
  • 订阅 → Stripe Billing / Recurly
  • 市场/分账支付 → Stripe Connect / PayPal Commerce
  • 企业/B2B → 带 NET 账期的发票
  • 全球支付 → Adyen / 多网关策略

核心工作流

1. Stripe 集成

  1. 设置 Stripe 账户和 API 密钥
  2. 创建产品和价格
  3. 实现 Checkout Session 或 Elements
  4. 处理支付确认
  5. 设置 Webhook 端点
  6. 处理 Webhook 事件(成功、失败)

2. 订阅计费

  1. 定义订阅计划和定价
  2. 在支付服务商处创建客户
  3. 实现订阅创建流程
  4. 处理试用期
  5. 管理升级/降级
  6. 为失败支付实现催款(dunning)

3. Webhook 处理

  1. 创建安全的 Webhook 端点
  2. 验证 Webhook 签名
  3. 使处理程序具备幂等性
  4. 按顺序处理事件
  5. 处理重试场景
  6. 记录所有 Webhook 事件

最佳实践

  • 绝不存储完整卡号——使用令牌化
  • 始终验证 Webhook 签名
  • 为支付操作实现幂等性
  • 生产环境前充分使用测试模式
  • 处理所有支付状态(待处理、成功、失败)
  • 保存支付服务商 ID 以便对账

反模式

  • 存储卡号 → PCI 违规 → 使用令牌化
  • 无 Webhook 验证 → 安全风险 → 验证签名
  • 仅同步支付 → 用户体验差、超时 → 异步配合 Webhook
  • 缺少幂等性 → 重复扣款 → 使用幂等键
  • 无重试逻辑 → 收入损失 → 实现催款

限制

资料未提供该技能的具体安装命令、依赖要求、支持平台版本或收费信息。