更新日志

本文档站遵循语义化版本思路记录面向商户的契约变化。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 页面框架和非商户工具栏。