更新日志

商户 API 接口与开发者文档的发布说明。版本依循后端发布 tag。内部基础设施变更（部署管线、多租户重构、CI 升级等）只记录于代码仓，刻意不列在此处。

如何阅读本更新日志

• 每个版本将变更归类为 新增、变更、废弃、移除、安全 与 修复。空白区段会省略。
• 需要商户端调整的条目以 ⚠ 破坏性变更 开头。
• 条目尽可能连结到对应的章节。
• 文档站版本依循后端发布 tag。并非每个后端发布都会带来商户接口的变更；对商户不可见的发布会标示为 internal-only，让版本与 tag 的对应保持连续。

[未发布]

• 文档：Wave 3 — Security、FAQ 与 Changelog 三语（en / zh-Hant / zh-Hans）章节，并新增 i18n 完整性 CI 把关，当章节跨语系不同步时 PR 检查会失败。连结将于 PR 合并后补上。

[v0.53.0] — 2026-05-20

新增

• 文档：Wave 2 — Quickstart、Deposits、Withdrawals 与 Callbacks 三语（en / zh-Hant / zh-Hans）章节。包含 5 张 Mermaid 流程图，涵盖 deposit-direct、deposit-cashier、withdrawal、callback-handshake 与 error-recovery 序列。章节之间的交叉连结现在涵盖所有常见商户情境。

修复

• 文档：Sandbox 章节的端点路径从 /api/v1/merchant/deposit 修复为 /api/v1/merchant/orders/deposit。响应信封形状从 {"code": 0} 修复为 {"success": true, "code": "SUCCESS"}，以对齐实际的服务器响应。三个语系皆受影响。

PR：#89

[v0.52.1] — 2026-05-20

内部发布；无商户 API 接口或文档变更。（运营主控台的前端 impersonation 横幅修复，不属于商户 API。）

[v0.52.0] — 2026-05-20

新增

• 文档：Wave 1 — Errors 与 Sandbox 三语章节。Errors 章节是商户 API 的标准 HTTP 状态码 + 业务码参考；Sandbox 章节记录测试凭证、fixture 金额与手动 callback 触发方式。
• 代码样本：verify.{sh,py,php,ts} callback 签名验证样本新增于 docs-site/shared/code-samples/。由 Callbacks 章节引用（该章节于 v0.53.0 上线）。
• CI：跨语言样本一致性测试在 CI（docs-pr-check.yml）强制执行 — 四个 verify.* 样本必须接受相同的 fixture 并返回相同结果，避免各语言版本偏离。

PR：#86

[v0.51.0] — 2026-05-19

新增

• 文档：docs.open-pay.co 基础设施上线。VitePress 站点含三个语系（en / zh-Hant / zh-Hans）、Authentication 章节（EN seed）、由过滤后的 OpenAPI 导出自动生成的 API Reference、侧栏/导览、搜索，以及 PR/release CI 部署至 Cloudflare Pages。
• 代码样本：sign.{sh,py,php,ts} 请求签名样本新增于 docs-site/shared/code-samples/。由 Authentication 章节引用 — 四个样本以相同输入生成相同签名，并由 CI 检查。
• 后端：新增 python -m app.cli export-openapi --scope merchant CLI 以导出过滤后的 OpenAPI（仅商户 tag 路由，排除内部 admin/platform 路由）。属于支持 API Reference 构建的内部工具；商户不会直接调用。

PR：#78

[v0.50.0] — 2026-05-19

内部发布；无商户 API 接口或文档变更。（OL 环境的集中式日志基础设施与 platform-console picker 修复；两者皆不影响商户 API。）

更早期的版本

v0.50.0 之前的发布历史早于商户文档站。更早的商户 API 变更未在此编目；若你需要特定端点、callback payload 或 schema 字段的历史脉络，咨询你的客户经理。