关于 payment-integration
用于支付网关集成与账单系统设计的技能,涵盖结账流程、订阅、Webhook 处理和 PCI-DSS 实践。
主要功能
- 01支付网关与结账集成
- 02订阅计费设计
- 03安全处理 Webhook
- 04支付重试与幂等性
- 05遵循 PCI-DSS 的支付实践
适用场景
- 01接入 Stripe 或 PayPal 支付
- 02构建周期性计费
- 03处理支付 Webhook
- 04规划多币种开票
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ 404kidwiz/ claude-supercode-skills --skill payment-integration安装后在 Claude Code 中输入/payment-integration确认已加载。
详细介绍
支付集成
用途
提供集成支付网关和设计符合 PCI 标准的账单系统方面的专业知识。专长包括使用 Stripe、PayPal 和 Adyen 等服务商实现结账流程、订阅管理和支付处理。
适用场景
- 集成 Stripe、PayPal 或其他支付网关
- 实现结账和支付流程
- 构建订阅账单系统
- 确保符合 PCI-DSS 标准
- 处理支付 Webhook
- 实现支付重试逻辑
- 设置多币种支付
- 构建开票系统
快速开始
在以下情况调用此技能:
- 集成支付网关(Stripe、PayPal、Adyen)
- 构建结账或订阅流程
- 设计符合 PCI 标准的支付系统
- 实现支付 Webhook 处理程序
- 设置定期账单
以下情况请勿调用:
- 总账/会计系统 → 使用
/fintech-engineer - 不涉及支付的 API 设计 → 使用
/api-designer - 仅限前端结账 UI → 使用
/frontend-design - 安全审计 → 使用
/security-auditor
决策框架
Payment Use Case?
├── One-time Purchase
│ └── Stripe Checkout / PayPal Buttons
├── Subscription
│ └── Stripe Billing / Recurly
├── Marketplace/Split Payments
│ └── Stripe Connect / PayPal Commerce
├── Enterprise/B2B
│ └── Invoicing with NET terms
└── Global Payments
└── Adyen / Multi-gateway strategy
核心工作流
1. Stripe 集成
- 设置 Stripe 账户和 API 密钥
- 创建产品和价格
- 实现 Checkout Session 或 Elements
- 处理支付确认
- 设置 Webhook 端点
- 处理 Webhook 事件(成功、失败)
2. 订阅账单
- 定义订阅方案和定价
- 在支付服务商处创建客户
- 实现订阅创建流程
- 处理试用期
- 管理升级/降级
- 为失败的支付实现催收流程
3. Webhook 处理
- 创建安全的 Webhook 端点
- 验证 Webhook 签名
- 确保处理程序具备幂等性
- 按顺序处理事件
- 处理重试场景
- 记录所有 Webhook 事件
最佳实践
- 切勿存储完整卡号——使用令牌化
- 始终验证 Webhook 签名
- 为支付操作实现幂等性
- 在生产环境部署前充分使用测试模式
- 处理所有支付状态(待处理、成功、失败)
- 存储支付服务商 ID,以便对账
反模式
| 反模式 | 问题 | 正确做法 |
|---|---|---|
| 存储卡号 | 违反 PCI 标准 | 使用令牌化 |
| 不验证 Webhook | 安全风险 | 验证签名 |
| 仅使用同步支付 | 用户体验差、超时 | 使用异步处理和 Webhook |
| 缺少幂等性 | 重复扣款 | 使用幂等性密钥 |
| 没有重试逻辑 | 收入损失 | 实现催收流程 |
评论
支持 Markdown