> ## 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.

# API 版本历史

> Waffo API 版本历史与变更日志。

<Note>
  本页记录 **Waffo API** 的版本历史。查找 **SDK 包**（Node.js / Java / Go）的版本更新，请见 [SDK 更新日志](/docs/zh/developer-docs/sdk/changelog)。
</Note>

| 版本   | 日期         | 变更                                                                                                                                                                                                                                            |
| ---- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 | 初始发布                                                                                                                                                                                                                                          |