本页记录 Waffo API 文档和外部合同的修订序列。表中的
v1.3 不是请求头 X-API-VERSION 的值；原始 HTTP 当前使用 1.0.0，SDK 会自动管理该请求头，请勿手动设置或覆盖。查找 SDK 包（Node.js / Java / Go / Python）的版本更新，请见 SDK 更新日志。| 版本 | 日期 | 变更 |
|---|---|---|
| v1.3 | 2026-08-24 | 新增 Reported Fraud 查询 API POST /api/v1/fraud-report/list；订单和订阅支付信息新增 receiptTemplateId；Chargeback 详情和列表响应新增 merchantOrderId；Chargeback 查询请求的 chargebackId 和 originalOrderId 不再标记为必填 |
| v1.3 | 2026-08-21 | 公开错误代码表新增 A0048、A0049、A0050、A0054，用于订阅套餐变更进行中、取消中、已成功支付和并发处理场景 |
| v1.3 | 2026-08-20 | 新增点卡充值（Waffo Point Topup）API：GET /redirect 签名跳转端点、POST /api/v1/gamepin/fulfillment-inquiry 履行结果查询，以及 FULFILLMENT_RESULT_NOTIFY 履行结果通知 Webhook |
| v1.3 | 2026-07-24 | 将订阅创建请求 subscriptionManagementUrl 标记为必填；支付方式详情 PayMethodDetail 新增币种、订单金额上下限、支付方式类型和是否支持退款字段，currentStatus 不再标记为必填；Payout 订单数据 PayoutOrderData 恢复 mid 和 subMid，并更新 Payout 收款账号、描述和用途说明；卡信息 AcqCardInfo 的卡号、有效期、CVV 和持卡人姓名不再标记为必填 |
| v1.3 | 2026-07-22 | 补充订单创建和订阅创建请求中 userEmail 的说明，明确该字段必填；缺少真实邮箱时应传入按用户 ID 构造的唯一 fallback 邮箱，并避免使用占位值或多人共用同一邮箱 |
| v1.3 | 2026-07-20 | 调整 OpenAPI 嵌套对象 schema 命名，使用父请求或响应上下文区分 MerchantInfo、PromotionInfo、SubscriptionInfo 等共享对象，避免组件名冲突 |
| v1.3 | 2026-07-17 | 公开错误代码表新增 A0047，用于表示收银台页面语言值不符合 IETF BCP 47 |
| v1.3 | 2026-07-15 | Payout 订单数据 PayoutOrderData 新增实际手续费字段 actFeeAmount，并移除旧字段 feeAmount、mid 和 subMid |
| v1.3 | 2026-07-13 | 新增订单 capture API POST /api/v1/order/capture，用于 Auth-Capture 手动扣款确认 |
| v1.3 | 2026-07-08 | 临时同步公开错误代码表，补充 A0025、A0028、A0033-A0037、A0039-A0046、B0008-B0013、D0002；订阅创建和订阅变更的 payMethodName 最大长度从 24 调整为 256；补充订阅创建 paymentInfo 示例；优化订单创建 payMethodProperties 说明 |
| v1.2 | 2023-09-15 | 新增 Direct Payment 产品类型；更新错误码 A0019、A0020、A0021 |
| v1.1 | 2023-05-31 | 新增 riskData 风控数据；为 BNPL 支付方式新增 AddressInfo 和 GoodsInfo；更新错误码 |
| v1.0 | 2023-03-15 | 初始发布 |