自 V20261001 版本起，两项产品名称更新如下，仅涉及名称与文档展示，接口及对接方式不变。
- 「美金包装」更名为「美元计价支付」（USD-Denominated Payments）
- 「国际信用卡」更名为「信用卡支付」（Credit Card Payments）
本次更新涵盖印度代收付限额调整、全量示例数据真实化、API Playground 多语言代码自动生成、测试环境标识标注以及错误响应示例补充，系统性提升文档专业度与商户接入效率。最近更新：
- 印度代收限额由 100-25000 INR 调整为 1-25000 INR，代付限额统一调整为 500-300000 INR
- 优化了地区示例数据，同步了过时的手机号与金额格式说明
- 提供了更详细的错误信息，为各 API 端点补充错误响应示例
- 添加测试环境标识，明确示例请求所使用的环境地址
- 启用 API Playground 多语言代码自动生成，支持 bash（curl）、Python、Node.js
台币（TWD）付款收款人姓名校验规则升级，新增繁体中文限制，确保收款人姓名符合台湾地区银行账户实名要求。最近更新：
- 新增 TWD 付款收款人姓名繁体中文校验，出款时校验姓名仅允许繁体汉字
全新「HaiPay 配置与签名指南」上线，完整覆盖新版密钥配置面板的核心操作与安全实践，中英文双语同步发布。最近更新：
- 新增 V20260801 版本「配置与签名」指南，覆盖面板总览、关联业务ID筛选、新增/更换密钥、业务ID映射等核心操作说明
- 详述两种密钥生成方式：HaiPay 平台一键生成 RSA 2048 密钥对（推荐）与自行创建公私钥（OpenSSL / 在线工具 / Java、PHP 代码示例）
- 说明穿梭框业务ID映射、密钥覆盖提醒与二次确认高危操作流程，以及单独更换密钥或修改映射的操作差异
- 补充安全最佳实践、公钥格式要求（PEM / X.509）、SHA256WithRSA 签名规则与常见问题解答
- 配有公私钥签名/验签流程图与 14 张面板界面截图，中英文双语对照
新增约旦（JOD）与伊拉克（IQD）收款接口文档，中东市场支付能力再扩充。最近更新：
- 约旦（JOD）：新增代收接口
/jod/collect/apply，支持信用卡（PAYMENT_GATEWAY，编码 CARD），支持 VISA、MasterCard；新增 CliQ（编码 CLIQ）支付方式（PAYMENT_GATEWAY），交易限额 0.5-1999 JOD（2位小数） - 伊拉克（IQD）：新增代收接口
/iqd/collect/apply，支持 Zain Cash 钱包（EWALLET，编码 ZAIN），交易限额 250-10000000 IQD（仅支持整数金额，无小数位） - 同步更新中英文双语代收支付方式列表与导航配置（仅本币入口，暂不支持 USD 包装）
台币代付请求参数新增非必填参数最近更新：
- 新增
branchName（分行名称）和branchCode（分行代码）参数，确保台币代付正常处理。
公共接口文档拆分为独立页面，新增实时汇率查询 V2 接口，导航结构优化为下拉分组。最近更新：
- 公共接口文档由单页拆分为 7 个独立页面：账户查询、异步通知、对账文件链接获取、实时对账报表创建、对账报表查询、代付订单凭证、实时汇率查询
- 新增实时汇率查询 V2 接口（
/common/quote/v3/exchange-rate），支持按充值（Recharge）和提现（Withdraw）类型分别查询汇率，返回汇率最近更新时间 - 原实时汇率查询 V1 接口（
/common/quote/v1/exchange-rate）标记为已弃用 - 导航栏「公共支付」下新增「公共接口」下拉分组，便于快速定位各接口文档
- 同步更新中英文双语文档及导航配置
非洲四国：肯尼亚、南非新增代收接口，喀麦隆、坦桑尼亚支付文档全新上线，南非代付限额上调。最近更新：
- 肯尼亚（KES）：新增代收接口，支持移动支付（EWALLET），覆盖 M-Pesa（Safaricom）、Airtel Money、Equitel、T-Kash、Telcom Kenya，交易限额 1-100,000 KES
- 南非（ZAR）：新增代收接口，支持 Pay with Bank / Instant EFT（BANK_TRANSFER），覆盖 Standard Bank、Nedbank、FNB、ABSA 等 8 家银行；代付限额上调至 1-10,000,000 ZAR
- 喀麦隆（XAF）：全新上线代收、代付接口文档，支持 MTN Mobile Money 与 Orange Money，交易限额 1,000-5,000,000 XAF（仅支持整数金额，无小数位）
- 坦桑尼亚（TZS）：全新上线代收、代付接口文档，支持 Airtel Money、HaloPesa、Tigo Pesa、Vodacom M-Pesa，交易限额 1,000-5,000,000 TZS
- 四国同步上线中英文双语 API Reference（OpenAPI 交互式文档）
埃及（EGP）代付接口文档补充钱包账号运营商限制说明。最近更新：
- 代付申请接口
accountNo字段说明新增运营商限制：钱包账号手机号仅支持 010、011、012 开头的运营商 - 同步更新中英文 API 文档及 API Reference（OpenAPI 交互式文档）
新增台湾地区（TWD）代付接口文档，支持银行账户转账方式，覆盖 31 家台湾银行。最近更新：
- 新增台湾（TWD）代付申请接口
/twd/pay/apply，支持银行账户（BANK_ACCOUNT）转账，交易限额 1000-49999 TWD - 支持 31 家台湾银行，包括臺灣銀行、臺灣土地銀行、合作金庫、中華郵政、中國信託、玉山銀行、永豐銀行、台新銀行等
- 新增代付查询接口及完整银行编码列表
- 同步上线中英文 API 文档及 API Reference（OpenAPI 交互式文档）
新增信用卡、Apple Pay、Google Pay 支持地区列表页，并提供一键复制 JSON 功能，方便商户快速获取完整地区数据。最近更新：
- 新增「信用卡支持的地区列表」页面，覆盖 61 个国家和地区
- 提供一键复制按钮，支持导出完整地区 JSON 数据，便于程序集成
- 中英文文档同步上线
代收下单接口新增
cancelUrl 字段，支持在用户取消支付后跳转到指定页面。最近更新：- 为全球收银台及各区域代收下单接口新增
cancelUrl请求参数 cancelUrl用于指定用户在支付页取消支付后的跳转地址- 同步更新中文与英文 API Reference 版本文档
发布全新信用卡集成文档，提供更清晰的集成方式选择与更完善的测试支持。最近更新：
- 新增「前置组件」和「支付链接」两种集成方式的文档，商户可根据业务场景灵活选择
- 旧版 JS SDK 集成方式正式废弃，建议迁移至「前置组件」以获得更好的支付体验
- 补充 VISA / MasterCard / JCB / DINERS / DISCOVER / AMEX 全卡组织测试卡号，方便联调测试
- 订阅支付文档简化，移除了已废弃的集成方式，保留当前推荐的接入方案
肯尼亚（KES）银行编码和电子钱包编码全面升级为字母代码。最近更新：
- 肯尼亚银行支付（BANK_ACCOUNT）编码从数字代码（如 0001、0002）更新为字母代码（如 KCB、SCB、ABK 等），共 46 家银行，按银行名称字母排序
- 肯尼亚电子钱包（EWALLET）编码从数字代码（0001、0002、0003、63907、97）更新为字母代码：SAFARICOM、AIRTEL、EQUITEL、TK、TKe
- 同步更新代付申请接口的请求示例，bankCode 参数已使用新的字母编码
新增公共接口 OpenAPI 交互式文档，将原有公共能力统一纳入 API Playground。最近更新：
- 新增公共接口 OpenAPI 规范（
common.openapi.json），支持在 API Playground 中直接调试 - 新增账户查询、代付订单凭证、支付凭证 PDF/ZIP、商户支付配置查询 4 个端点的交互式文档
- 同步新增中英文导航入口，归入「API 文档」Tab 下的「公共接口」分组
自定义组合模式组件新增配置参数与事件回调。最近更新：
- 新增
cardPosition参数，支持控制信用卡表单放置位置，默认bottom，可选top - 新增
paymentMethodType事件回调，用于监听用户选择的支付方式类型变化
新增肯尼亚（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 定义文件
自定义组合模式组件新增配置参数，并清理已废弃支付组件的相关文档说明。最近更新：
- 自定义组合模式新增
showPayButton参数，支持控制信用卡提交按钮是否显示，默认false（不显示） - 下线信用卡 API 文档中 Apple Pay / Google Pay
token参数的获取方式说明（How to get?链接），原 Apple Pay / Google Pay 独立组件已废弃，推荐统一迁移至「自定义组合模式」
新增自定义组合模式，旧组件即将废弃。最近更新：
- 新增「自定义组合模式」组件（
composite-component），支持通过mode参数切换普通支付与订阅支付； - Apple Pay / Google Pay、Credit Card，推荐迁移至「自定义组合模式」。
更新了TRY的可用支付方式。最近更新：
- 由于土耳其当地支付条件变更，导致一些支付方式不可用，现已同步文档更新
更新了美元的API对接文档。最近更新：
- 删除一些代付支持的钱包
新增 HaiPay AI Skills 文档，为商户提供 AI 驱动的集成加速方案。最近更新：
- 新增 AI Skills 助力 HaiPay 集成文档（中英文双语），介绍如何通过 Skills 让 AI 代理遵循最佳实践完成支付对接
- 支持通过 npx 一键安装 HaiPay Skills 到项目中
- 介绍 AI 辅助开发平台在 HaiPay 集成中的应用
- 提供 HaiPay Skills 官方目录访问地址
更新了马来西亚API对接文档。最近更新：
- 增加一些代付支持的钱包
更新了退款API对接文档。最近更新：
- 退款支持指定退款金额，即部分退款。
调整了USD的代付方式配置。最近更新：
- 新增 USD 代付方式 ECASHAPP，支付类型为 EWALLET；
- 更新尼日利亚代付银行账号示例。
更新了尼日利亚 API 对接文档。最近更新：
- 修订银行名称映射；
- 清理失效银行编码；
- 补充新增银行数据。
扩展非洲与新加坡的 API 支持。最近更新：
- 新增尼日利亚 API 文档并开通代付服务；
- 新加坡代收支付方式由电子钱包调整为 QR。
新增 HaiPay MCP 工具集成文档，提升商户支付对接效率。最近更新：
- MCP 工具与插件连接文档；
- MCP 使用场景示例（快速接入支付、查询 API 参数、排查问题等）；
- 支持 AI 助手实时获取 API 文档、签名规则、错误码说明和最佳实践；
- 降低商户对接门槛，提升集成效率。
本次围绕 API 导览体验和页面辅助能力做了组合更新，同时合并整理了主分支同步内容，重点提升文档入口清晰度、AI 辅助能力和支付资料可读性。最近更新：
- 为 API 文档新增中英文简介页，并接入
/docs/zh/api-reference/overview与英文对应路径，帮助开发者先理解能力范围、阅读路径和核心接口分组 - 重构中英文“支付接口文档列表”页面，改为卡片式导航入口，支持按产品能力和地区快速浏览，不再只是简单链接堆叠
- 扩展 contextual AI 入口，新增 Kimi 和 GLM 的试验性入口，修复通义千问打开时的多余前缀文案，并调整国内 AI 入口的展示顺序
- 补充历史指南路径重定向，并新增
.mintignore，减少旧链接失效和构建干扰 - 调整 RSA 密钥生成说明，移除 HaiPay 托管生成地址，改为更通用的在线生成指引
- 将欧洲支付方式页和中英文银行代码列表由嵌入式 HTML 表格整理为 Markdown 表格，提升维护性与阅读体验
本次继续完善 HaiPay 中英文商户文档体验，重点提升接入入口清晰度和 API 查找效率。最近更新：
- 围绕商户接入旅程重构首页与指南入口，明确接入流程、配置签名、测试验收和上线准备等关键路径
- 更新站点元信息、重定向、搜索提示和页面描述，增强 SEO 覆盖与文档可发现性
- 清理接口文档列表和页面跳转链接，修复双斜杠路径等历史链接问题
- 为大批量 API 参考页补充相关接口推荐，提升联调过程中跨页面查找与跳转效率
圆满完成 HaiPay 文档从 VuePress 到 Mintlify 的整体迁移，这是全新文档版本的起点。最近更新：
- 完成中英文双语文档结构整理与切换
- 重构导航层级，按用户使用路径组织内容入口
- 将商户指南首页升级为导航卡片，提升查找效率
- 清理历史无关示例内容，统一更新日志写法