维护依据与待确认项
联调与上线前,请结合本页的实现限制和待确认清单,核实目标环境实际开通的能力。具体测试场景见测试与排障。
文档依据
本页保留原始新加坡接入文档中记录的核对依据,包括 MIS 专用收款设备接口文档(原文读取修订号 407)以及下列本地代码版本。
原文组织方式参考《Stripe 文档设计调研与聚合支付平台指导建议》:先完成业务任务,再深入接口参考,给出异常恢复与验收证据。Stripe 的接口或幂等规则没有被移植为 AiMT 契约。
以下版本和代码位置来自原文的核对记录。本次补齐文档不代表重新核验这些仓库,也不代表目标环境已部署对应版本或已通过真实终端、渠道验收。
代码核对范围
原文记录的代码位置
- 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 依赖版本存在差异,须使用目标环境的真实签名样本完成最终回调验签联调。
差异修正记录
已知实现限制
- 查询路径:
/mis/query在入口已注册,但原文核对的 frontend-proxy 没有对应实现。因此本组文档使用已核对的/upay/v2/query。 - 取消通知覆盖:
tradePush的cancel_notify_url在部分通联/KPay 转发路径未传递,不承诺所有设备均可收到取消通知。按目标设备与路由验证取消通知,并结合查单核实最终结果。
联调与上线前待确认
原文覆盖核对
2026-11-12 对照原始 HTML 文档核查中英文版本,覆盖每种语言的 26 个带锚点章节、方案概览、26 张表格(含表头共 197 行)以及 34 个代码/示例块(含可下载的 Python 源码)。未发现接口章节、参数表或代码示例缺失;现有接入步骤图已保留三个阶段、八个步骤。
补回适用范围与回调示例中的来源/核验范围链接,将纯文本支付流程与订单状态主路径整理为 Mermaid,保留受理与支付成功的区别、查单恢复及退款能力边界。本次为文档对照,不代表重新核验后端源码或目标环境能力。
修订记录
-
2026-10-22,原文修订: 补充首笔交易、四层结果判定、异常恢复、错误码与测试清单;修正重试订单号、退款号语义、回调原文验签/应答/去重、签到响应密钥、退款和交班能力边界。原文保留既有章节锚点与中英切换,仅修改文档,不改变任何 API 行为。
-
2026-11-11,补齐 Markdown 板块: 恢复原文的维护依据、代码核对范围、差异记录、实现限制及待确认事项,保留本页
sources锚点,并提供中英文版本。未重新验证目标环境或改变 API 行为。 -
2026-11-12,原文核对与流程图补充: 按指定原文地址核查覆盖范围,恢复来源跳转,并同步补充中英文支付与订单状态 Mermaid 图。
