# 更新日志

本文档站遵循语义化版本思路记录面向商户的契约变化。OpenAPI 文件是 API 参考的机器可读事实来源。

## 2026-10-30

- 与 PSP 生产发布 `v1.0.0-rc.20261028.3` 对齐 Invoice、Transfer、Query 和商户 Webhook 契约。
- 修正 PIX 收款示例、收款系统单号、代付退款说明及幂等 Header 和冲突处理。
- 补充商户可用的请求、查询和响应结构，更新 Checkout 路由及令牌说明。

## 2026-09-03

- Pre-GA 破坏性移除 Transfer 与 Merchant Webhook 中的 runtime taxonomy version。
- 支付分类改为稳定 identity 快照；taxonomy tuple 的 `inactive` 只阻止新订单，不改变已接受订单。
- 保留 OpenAPI、Webhook header 和 `classification_schema_version` 等独立合同版本。

## 2026-08-27

- 首次发布商户 Gateway API 文档站。
- 按 Invoice、Transfer、Query、Merchant Webhook、Proof / Checkout 拆分参考文档。
- 增加 Ed25519 认证、幂等重试、Webhook 和上线检查指南。
- API Reference 使用独立全屏布局，移除重复的 VitePress 页面框架和非商户工具栏。