2026年7月09日
PaymentsCreditCardFront-End ComponentPayment LinkSubscriptionApplePayGooglePay
信用卡集成文档全面升级
发布全新信用卡集成文档，提供更清晰的集成方式选择与更完善的测试支持。最近更新：
- 新增「前置组件」和「支付链接」两种集成方式的文档，商户可根据业务场景灵活选择
- 旧版 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 定义文件
自定义组合模式组件新增配置参数与事件回调。最近更新：
- 新增
cardPosition参数，支持控制信用卡表单放置位置，默认bottom，可选top - 新增
paymentMethodType事件回调，用于监听用户选择的支付方式类型变化
自定义组合模式组件新增配置参数，并清理已废弃支付组件的相关文档说明。最近更新：
- 自定义组合模式新增
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 的整体迁移，这是全新文档版本的起点。最近更新：
- 完成中英文双语文档结构整理与切换
- 重构导航层级，按用户使用路径组织内容入口
- 将商户指南首页升级为导航卡片，提升查找效率
- 清理历史无关示例内容，统一更新日志写法