> ## Documentation Index
> Fetch the complete documentation index at: https://doc.haipay.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日志

> 产品更新和公告

<Update label="2026年7月27日" description="新增台湾地区代付接口文档" tags={["TWD", "Taiwan", "PayOut", "BankCode"]}>
  新增台湾地区（TWD）代付接口文档，支持银行账户转账方式，覆盖 31 家台湾银行。

  最近更新：

  * 新增台湾（TWD）代付申请接口 `/twd/pay/apply`，支持银行账户（BANK\_ACCOUNT）转账，交易限额 1000-49999 TWD
  * 支持 31 家台湾银行，包括臺灣銀行、臺灣土地銀行、合作金庫、中華郵政、中國信託、玉山銀行、永豐銀行、台新銀行等
  * 新增代付查询接口及完整银行编码列表
  * 同步上线中英文 API 文档及 API Reference（OpenAPI 交互式文档）
</Update>

<Update label="2026年7月22日" description="信用卡支持地区列表页上线" tags={["CreditCard", "ApplePay", "GooglePay"]}>
  新增信用卡、Apple Pay、Google Pay 支持地区列表页，并提供一键复制 JSON 功能，方便商户快速获取完整地区数据。

  最近更新：

  * 新增「信用卡支持的地区列表」页面，覆盖 61 个国家和地区
  * 提供一键复制按钮，支持导出完整地区 JSON 数据，便于程序集成
  * 中英文文档同步上线
</Update>

<Update label="2026年7月16日" description="代收下单接口新增 cancelUrl 字段" tags={["Collect", "API", "OpenAPI", "Docs"]}>
  代收下单接口新增 `cancelUrl` 字段，支持在用户取消支付后跳转到指定页面。

  最近更新：

  * 为全球收银台及各区域代收下单接口新增 `cancelUrl` 请求参数
  * `cancelUrl` 用于指定用户在支付页取消支付后的跳转地址
  * 同步更新中文与英文 API Reference 版本文档
</Update>

<Update label="2026年7月09日" description="信用卡集成文档全面升级" tags={["Payments", "CreditCard", "Front-End Component", "Payment Link", "Subscription", "ApplePay", "GooglePay"]}>
  发布全新信用卡集成文档，提供更清晰的集成方式选择与更完善的测试支持。

  最近更新：

  * 新增「前置组件」和「支付链接」两种集成方式的文档，商户可根据业务场景灵活选择
  * 旧版 JS SDK 集成方式正式废弃，建议迁移至「前置组件」以获得更好的支付体验
  * 补充 VISA / MasterCard / JCB / DINERS / DISCOVER / AMEX 全卡组织测试卡号，方便联调测试
  * 订阅支付文档简化，移除了已废弃的集成方式，保留当前推荐的接入方案
</Update>

<Update label="2026年7月3日" description="肯尼亚银行及电子钱包编码更新" tags={["KES", "Kenya", "BankCode", "EWALLET"]}>
  肯尼亚（KES）银行编码和电子钱包编码全面升级为字母代码。

  最近更新：

  * 肯尼亚银行支付（BANK\_ACCOUNT）编码从数字代码（如 0001、0002）更新为字母代码（如 KCB、SCB、ABK 等），共 46 家银行，按银行名称字母排序
  * 肯尼亚电子钱包（EWALLET）编码从数字代码（0001、0002、0003、63907、97）更新为字母代码：SAFARICOM、AIRTEL、EQUITEL、TK、TKe
  * 同步更新代付申请接口的请求示例，bankCode 参数已使用新的字母编码
</Update>

<Update label="2026年7月2日" description="新增公共接口 API 文档" tags={["Common", "API", "Docs", "OpenAPI"]}>
  新增公共接口 OpenAPI 交互式文档，将原有公共能力统一纳入 API Playground。

  最近更新：

  * 新增公共接口 OpenAPI 规范（`common.openapi.json`），支持在 API Playground 中直接调试
  * 新增账户查询、代付订单凭证、支付凭证 PDF/ZIP、商户支付配置查询 4 个端点的交互式文档
  * 同步新增中英文导航入口，归入「API 文档」Tab 下的「公共接口」分组
</Update>

<Update label="2026年6月25日" description="自定义组合模式参数与事件更新" tags={["Payments", "Component", "CreditCard", "Subscription"]}>
  自定义组合模式组件新增配置参数与事件回调。

  最近更新：

  * 新增 `cardPosition` 参数，支持控制信用卡表单放置位置，默认 `bottom`，可选 `top`
  * 新增 `paymentMethodType` 事件回调，用于监听用户选择的支付方式类型变化
</Update>

<Update label="2026年6月23日" description="肯尼亚与南非区域支付文档上线" tags={["KES", "ZAR", "Kenya", "SouthAfrica", "PayOut", "BankCode", "EWALLET"]}>
  新增肯尼亚（KES）和南非（ZAR）区域代付接口文档，扩展非洲市场支付能力。

  最近更新：

  * 新增肯尼亚（KES）代付 API 文档，支持移动支付（EWALLET）方式，包括 M-Pesa（Safaricom）、Airtel Money、Equitel、T-Kash、Telcom Kenya，交易限额 10-999,999 KES
  * 肯尼亚银行支付（BANK\_ACCOUNT）现已开放，支持 40 家银行，包括 Kenya Commercial Bank、Standard Chartered Bank、ABSA Bank Kenya、Equity Bank 等
  * 新增南非（ZAR）代付 API 文档，支持银行转账（BANK\_ACCOUNT）方式，覆盖 Standard Bank、Nedbank、FNB、ABSA、Capitec Bank 等 20 家银行，交易限额 2-1,000,000 ZAR
  * 新增 KES 和 ZAR 的 API Reference 页面及 OpenAPI 定义文件
</Update>

<Update label="2026年5月28日" description="自定义组合模式参数更新与废弃组件文档清理" tags={["Payments", "Component", "Deprecation", "ApplePay", "GooglePay", "Token"]}>
  自定义组合模式组件新增配置参数，并清理已废弃支付组件的相关文档说明。

  最近更新：

  * 自定义组合模式新增 `showPayButton` 参数，支持控制信用卡提交按钮是否显示，默认 `false`（不显示）
  * 下线信用卡 API 文档中 Apple Pay / Google Pay `token` 参数的获取方式说明（`How to get?` 链接），原 Apple Pay / Google Pay 独立组件已废弃，推荐统一迁移至「自定义组合模式」
</Update>

<Update label="2026年5月21日" description="JS CDN 组件更新" tags={["Payments"]}>
  新增自定义组合模式，旧组件即将废弃。

  最近更新：

  * 新增「自定义组合模式」组件（`composite-component`），支持通过 `mode` 参数切换普通支付与订阅支付；
  * Apple Pay / Google Pay、Credit Card，推荐迁移至「自定义组合模式」。
</Update>

<Update label="2026年5月14日" description="Turkey支付方式更新" tags={["TRY", "PayIn","PayOut", "BankCode"]}>
  更新了TRY的可用支付方式。

  最近更新：

  * 由于土耳其当地支付条件变更，导致一些支付方式不可用，现已同步文档更新
</Update>

<Update label="2026年5月9日" description="USD代付方式更新" tags={["USD", "PayOut", "BankCode"]}>
  更新了美元的API对接文档。

  最近更新：

  * 删除一些代付支持的钱包
</Update>

<Update label="2026年5月7日" description="AI Skills 文档上线" tags={["AI", "Skills", "Integration", "Docs"]}>
  新增 HaiPay AI Skills 文档，为商户提供 AI 驱动的集成加速方案。

  最近更新：

  * 新增 AI Skills 助力 HaiPay 集成文档（中英文双语），介绍如何通过 Skills 让 AI 代理遵循最佳实践完成支付对接
  * 支持通过 npx 一键安装 HaiPay Skills 到项目中
  * 介绍 AI 辅助开发平台在 HaiPay 集成中的应用
  * 提供 HaiPay Skills 官方目录访问地址
</Update>

<Update label="2026年5月6日" description="MYR代付方式更新" tags={["MYR", "PayOut", "BankCode"]}>
  更新了马来西亚API对接文档。

  最近更新：

  * 增加一些代付支持的钱包
</Update>

<Update label="2026年4月28日" description="文档更新" tags={["Refund", "USD", "API", "refundAmount"]}>
  更新了退款API对接文档。

  最近更新：

  * 退款支持指定退款金额，即部分退款。
</Update>

<Update label="2026年4月27日" description="USD代付方式更新" tags={["Payments", "USD", "PayType"]}>
  调整了USD的代付方式配置。

  最近更新：

  * 新增 USD 代付方式 ECASHAPP，支付类型为 EWALLET；
  * 更新尼日利亚代付银行账号示例。
</Update>

<Update label="2026年4月24日" description="尼日利亚银行映射更新" tags={["Payments", "Nigeria", "BankMapping"]}>
  更新了尼日利亚 API 对接文档。

  最近更新：

  * 修订银行名称映射；
  * 清理失效银行编码；
  * 补充新增银行数据。
</Update>

<Update label="2026年4月20日" description="区域API扩展" tags={["Payments", "Nigeria", "Singapore", "API"]}>
  扩展非洲与新加坡的 API 支持。

  最近更新：

  * 新增尼日利亚 API 文档并开通代付服务；
  * 新加坡代收支付方式由电子钱包调整为 QR。
</Update>

<Update label="2026年4月18日" description="HaiPay MCP 工具集成" tags={["Integration", "MCP", "HaiPay", "AI"]}>
  新增 HaiPay MCP 工具集成文档，提升商户支付对接效率。

  最近更新：

  * MCP 工具与插件连接文档；
  * MCP 使用场景示例（快速接入支付、查询 API 参数、排查问题等）；
  * 支持 AI 助手实时获取 API 文档、签名规则、错误码说明和最佳实践；
  * 降低商户对接门槛，提升集成效率。
</Update>

<Update label="2026年4月16日" description="文档与体验更新" tags={["Docs", "AI", "API"]}>
  本次围绕 API 导览体验和页面辅助能力做了组合更新，同时合并整理了主分支同步内容，重点提升文档入口清晰度、AI 辅助能力和支付资料可读性。

  最近更新：

  * 为 API 文档新增中英文简介页，并接入 `/docs/zh/api-reference/overview` 与英文对应路径，帮助开发者先理解能力范围、阅读路径和核心接口分组
  * 重构中英文“支付接口文档列表”页面，改为卡片式导航入口，支持按产品能力和地区快速浏览，不再只是简单链接堆叠
  * 扩展 contextual AI 入口，新增 Kimi 和 GLM 的试验性入口，修复通义千问打开时的多余前缀文案，并调整国内 AI 入口的展示顺序
  * 补充历史指南路径重定向，并新增 `.mintignore`，减少旧链接失效和构建干扰
  * 调整 RSA 密钥生成说明，移除 HaiPay 托管生成地址，改为更通用的在线生成指引
  * 将欧洲支付方式页和中英文银行代码列表由嵌入式 HTML 表格整理为 Markdown 表格，提升维护性与阅读体验
</Update>

<Update label="2026年4月15日" description="文档更新" tags={["Docs", "Navigation", "API"]}>
  本次继续完善 HaiPay 中英文商户文档体验，重点提升接入入口清晰度和 API 查找效率。

  最近更新：

  * 围绕商户接入旅程重构首页与指南入口，明确接入流程、配置签名、测试验收和上线准备等关键路径
  * 更新站点元信息、重定向、搜索提示和页面描述，增强 SEO 覆盖与文档可发现性
  * 清理接口文档列表和页面跳转链接，修复双斜杠路径等历史链接问题
  * 为大批量 API 参考页补充相关接口推荐，提升联调过程中跨页面查找与跳转效率
</Update>

<Update label="2026年4月14日" description="v1.0.0" tags={["Mintlify", "Migration"]}>
  圆满完成 HaiPay 文档从 VuePress 到 Mintlify 的整体迁移，这是全新文档版本的起点。

  最近更新：

  * 完成中英文双语文档结构整理与切换
  * 重构导航层级，按用户使用路径组织内容入口
  * 将商户指南首页升级为导航卡片，提升查找效率
  * 清理历史无关示例内容，统一更新日志写法
</Update>

## 相关主题

* [HaiPay API 文档简介](/docs/zh/api-reference/overview)
* [HaiPay 集成步骤指南](/docs/zh/guide/integration_guide)
* [HaiPay 接口说明与公共规则](/docs/zh/guide/api_description_guide)