本页记录 Waffo API 的版本历史。查找 SDK 包（Node.js / Java / Go）的版本更新，请见 SDK 更新日志。
| 版本 | 日期 | 变更 |
|---|---|---|
| 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 | 初始发布 |