waffo-integrate 是 Waffo 官方的 AI 集成 Skill，帮助开发者通过交互式向导自动完成 SDK 集成。支持 Claude Code、Cursor 等 AI 编码工具。Documentation Index
Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
接入路线图
为什么使用 waffo-integrate
| 指标 | 使用 Skill | 手动集成 | 提升 |
|---|---|---|---|
| 集成通过率 | 100% | 75% | +25% |
| 平均耗时 | 128s | 192s | -33% |
| Token 消耗 | 58.8k | 66.3k | -11% |
安装
集成流程
验证完成后，请将生成的测试报告发送到贵司和 Waffo 的技术对接群（企微或 Lark 群），用于确认集成结果。
内置 13 条 API 规则
Skill 内置的规则自动防止常见错误：| # | 规则 | 防止的问题 |
|---|---|---|
| 1 | Request ID 最长 32 字符 | 超过 Waffo 幂等键长度限制 |
| 2 | 订阅用 currency 不是 orderCurrency | 字段名混淆 |
| 3 | 订阅用 amount 不是 orderAmount | 字段名混淆 |
| 4 | 各操作的必填字段检查 | 缺少 payMethodType、goodsInfo 等 |
| 5 | periodType 仅 DAILY/WEEKLY/MONTHLY | 无效枚举 YEARLY、MONTH |
| 6 | periodInterval 是 String 不是 Number | 类型错误 |
| 7 | 订阅必传 payMethodType | SDK 报错 A0003 |
| 8 | productName 仅 ONE_TIME_PAYMENT / SUBSCRIPTION | 无效产品类型 |
| 9 | 响应使用 isSuccess() 检查 | 遗漏错误处理 |
| 10 | Webhook 必须验签 + 响应签名 | 安全漏洞 |
| 11 | Java 使用 WaffoConfig.builder() | SDK 初始化失败 |
| 12 | 时间戳 SDK 自动注入 | 手动时间戳格式错误 |
| 13 | merchantId SDK 自动注入 | 重复设置 |
生成的代码特性
- 错误处理：区分
WaffoUnknownStatusError（可能成功）和WaffoError（客户端错误） - 安全：Webhook 签名验证 + 响应签名、环境变量管理凭证
- 最佳实践：幂等请求 ID、服务层分离、Webhook 先注册后解析 JSON
- 测试：沙盒集成测试桩、测试卡号