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