版本与变更日志

更新： 2026-09-18 当前对外主版本： /open/v1

版本规则

• API 主版本体现在路径中，如 /open/v1/...。
• 同一主版本可新增可选请求字段、响应字段、枚举值、接口与事件；客户端需忽略未识别字段并安全降级未识别枚举。
• 破坏性变更通过新的路径主版本发布，具体并行期随该次变更公告确定，不在本页承诺固定天数。
• Webhook 当前事件名为 payment.succeeded、payment.failed、payment.closed、refund.succeeded 和 refund.failed；不自行追加文档未定义的版本后缀。

变更日志

日期	版本	说明
2026-09-18	OpenAPI 1.0.0	公布支付会话、退款、托管收银台与 Webhook 实际合同；接入指南与运行时统一
2026-09-17	OpenAPI 1.0.0	明确 HMAC v2、写请求幂等和 Webhook 验签规则
2026-08-02	v1 设计基线	建立开发者文档结构，不作为生产接口开通证明

如何判断能力是否可用

1. 路径必须出现在自动生成的 OpenAPI 接口定义中。
2. 商户工作台中对应支付产品、场景和应用授权必须已启用。
3. 生产凭据、通道签约和上游验收必须已完成。

当前未发布邮件或 Webhook 形式的变更订阅 API。上线前的变更通知渠道和迁移周期需随生产运营制度一并确定。