> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt. # 维护依据与待确认项 \{#sources} 联调与上线前,请结合本页的实现限制和待确认清单,核实目标环境实际开通的能力。具体测试场景见[测试与排障](/zh/guide/testing.md#testing)。 ## 文档依据 本页保留[原始新加坡接入文档](https://aimt-horizon.com/AIMT_PAY_API_DOC.html#sources)中记录的核对依据,包括 [MIS 专用收款设备接口文档](https://sqb.feishu.cn/wiki/QsZ4wfldiiN47ikRCPAcWQ4snpg)(原文读取修订号 **407**)以及下列本地代码版本。 原文组织方式参考《Stripe 文档设计调研与聚合支付平台指导建议》:先完成业务任务,再深入接口参考,给出异常恢复与验收证据。Stripe 的接口或幂等规则没有被移植为 AiMT 契约。 :::info 核对范围 以下版本和代码位置来自原文的核对记录。本次补齐文档不代表重新核验这些仓库,也不代表目标环境已部署对应版本或已通过真实终端、渠道验收。 ::: ## 代码核对范围 | 来源 | 核对版本 | 核对内容 | | ----------------------------- | -------------- | ------------------------------------------------------ | | upay-api(仓库 `api`) | `9b55d08268a7` | 公网路由、原始字节签名、Header/Body 一致性、签到新密钥。 | | app-push-service | `f2f1555d095c` | 推送结果码、设备归属及通知转发范围。 | | upay-frontend-proxy | `e1238c7` | 退款参数、目标支付终端转换、`client_sn` 映射。 | | upay-gateway | `f5f8dbc7e0ed` | 查询作用域、退款状态、回调与重试。 | | mpay-sdk-homebrew(RSA 编码补充源码) | `4c5037791fee` | RSA 签名采用 Base64 编码;该本地 SDK 版本与 gateway 声明的 `2.7.6` 不同。 | :::details 原文记录的代码位置 - **upay-api:** `internal/router/router.go:129,146`;`internal/auth/auth.go:113,218,343`;`internal/router/admin/admin.go:154`。 - **app-push-service:** `MisTradePushController.java:45,161`;`MisPushApiExceptionEnumV2.java`;`MisServiceImpl.java:177`;`AllinpayServices.java:35,114`。 - **upay-frontend-proxy:** `MisPushController.java:23`;`MisPushServiceImpl.java:109,166,273`。 - **upay-gateway:** `UpayServiceImpl.java:531,1397,1410,1529`;`DataRepository.java:142`;`RefundProcessor.java:484,787,916`;`ClientNotifier.java:85,276,300`;`TransactionResponder.java:93,133`。 - **RSA 编码补充源码:** `mpay-sdk-homebrew/RsaSignature.java:68,199`。 ::: 由于 RSA 补充源码与 gateway 依赖版本存在差异,须使用目标环境的真实签名样本完成最终[回调验签联调](/zh/guide/signing-notifications.md#auth-callback)。 ## 差异修正记录 | 原文核对项 | 文档采用的结论 | | -------------------------- | ------------------------------------------------------------------------------------ | | 飞书表格中的 `PUSH_SUCCESSS` | 按实现纠正为 `PUSH_SUCCESS`,见[订单推送](/zh/api/pushorder.md)。 | | 退款示例中的 `refund_client_tsn` | 按参数表和实现纠正为 `refund_request_no`,见[服务端退款](/zh/api/refund.md)。 | | 退款号长度 | 按已核对的 **31 字符**限制说明。 | | `1 / 5 / 30 / 600` 秒重试间隔 | 仅用于平台[回调通知重试](/zh/guide/signing-notifications.md#notification-details),不能作为支付请求重发策略。 | ## 已知实现限制 - **查询路径:** `/mis/query` 在入口已注册,但原文核对的 frontend-proxy 没有对应实现。因此本组文档使用已核对的 [`/upay/v2/query`](/zh/api/query.md)。 - **取消通知覆盖:** `tradePush` 的 `cancel_notify_url` 在部分通联/KPay 转发路径未传递,不承诺所有设备均可收到取消通知。按目标设备与路由验证[取消通知](/zh/guide/signing-notifications.md#notification-details),并结合查单核实最终结果。 ## 联调与上线前待确认 | 待确认项 | 确认方 | 所需证据 | | --------------------------- | -------- | ------------------------- | | 测试环境与凭证、真实扣款边界、商户 SGD 配置 | 平台接入团队 | 环境清单与可重复的测试样例。 | | 机型/固件、`pay_type` 映射、退款与撤销能力 | 设备与渠道负责人 | 目标设备的成功、失败、处理中用例。 | | 激活码有效期、重新激活、签到频率和公钥轮换 | 终端与平台负责人 | 当前开户说明及目标环境验签样本。 | | 退款期限、跨店权限、手续费、资金结算及对账 | 渠道/商户运营 | 当前合同、配置和账单样例。 | | 频控、业务确认时限、取消通知覆盖、交班完成确认 | 平台与设备负责人 | 配置或实测证据;不从本地默认实现推定线上 SLA。 | ## 原文覆盖核对 \{#original-coverage} 2026-11-12 对照[原始 HTML 文档](https://aimt-horizon.com/AIMT_PAY_API_DOC.html)核查中英文版本,覆盖每种语言的 26 个带锚点章节、方案概览、26 张表格(含表头共 197 行)以及 34 个代码/示例块(含可下载的 Python 源码)。未发现接口章节、参数表或代码示例缺失;现有接入步骤图已保留三个阶段、八个步骤。 | 原文章节 | 当前位置 | | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `overview`、方案概览、`scope`、`quickstart`、`terms`、`prerequisites` | [快速开始](/zh/guide/getting-started.md) | | `integration-journey`、`integration-flow`、`best-practices`、`response-states`、`reliability` | [业务指南](/zh/guide/business.md) | | `auth-signing`、`auth-callback`、`notify`、`notification-details`、`signature-summary` | [签名与通知](/zh/guide/signing-notifications.md) | | `activate`、`checkin`、`pushorder`、`mis-refund`、`refund`、`query`、`settlement`、`close` | [激活](/zh/api/activate.md)、[签到](/zh/api/checkin.md)、[推单](/zh/api/pushorder.md)、[设备退款](/zh/api/mis-refund.md)、[服务端退款](/zh/api/refund.md)、[查单](/zh/api/query.md)、[交班](/zh/api/settlement.md)、[关单](/zh/api/close.md) | | `errors`、`testing` | [测试与排障](/zh/guide/testing.md) | | `sources` | [维护依据与待确认项](#sources) | 补回适用范围与回调示例中的来源/核验范围链接,将纯文本支付流程与订单状态主路径整理为 Mermaid,保留受理与支付成功的区别、查单恢复及退款能力边界。本次为文档对照,不代表重新核验后端源码或目标环境能力。 ## 修订记录 - **2026-10-22,原文修订:** 补充首笔交易、四层结果判定、异常恢复、错误码与测试清单;修正重试订单号、退款号语义、回调原文验签/应答/去重、签到响应密钥、退款和交班能力边界。原文保留既有章节锚点与中英切换,仅修改文档,不改变任何 API 行为。 - **2026-11-11,补齐 Markdown 板块:** 恢复原文的维护依据、代码核对范围、差异记录、实现限制及待确认事项,保留本页 `sources` 锚点,并提供中英文版本。未重新验证目标环境或改变 API 行为。 - **2026-11-12,原文核对与流程图补充:** 按指定原文地址核查覆盖范围,恢复来源跳转,并同步补充中英文支付与订单状态 Mermaid 图。