For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/guide/sources.md.
  • 简体中文
  • 维护依据与待确认项

    联调与上线前,请结合本页的实现限制和待确认清单,核实目标环境实际开通的能力。具体测试场景见测试与排障。

    文档依据

    本页保留原始新加坡接入文档中记录的核对依据,包括 MIS 专用收款设备接口文档(原文读取修订号 407)以及下列本地代码版本。

    原文组织方式参考《Stripe 文档设计调研与聚合支付平台指导建议》:先完成业务任务,再深入接口参考,给出异常恢复与验收证据。Stripe 的接口或幂等规则没有被移植为 AiMT 契约。

    核对范围

    以下版本和代码位置来自原文的核对记录。本次补齐文档不代表重新核验这些仓库,也不代表目标环境已部署对应版本或已通过真实终端、渠道验收。

    代码核对范围

    来源核对版本核对内容
    upay-api(仓库 api)9b55d08268a7公网路由、原始字节签名、Header/Body 一致性、签到新密钥。
    app-push-servicef2f1555d095c推送结果码、设备归属及通知转发范围。
    upay-frontend-proxye1238c7退款参数、目标支付终端转换、client_sn 映射。
    upay-gatewayf5f8dbc7e0ed查询作用域、退款状态、回调与重试。
    mpay-sdk-homebrew(RSA 编码补充源码)4c5037791feeRSA 签名采用 Base64 编码;该本地 SDK 版本与 gateway 声明的 2.7.6 不同。
    原文记录的代码位置
    • 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 依赖版本存在差异,须使用目标环境的真实签名样本完成最终回调验签联调。

    差异修正记录

    原文核对项文档采用的结论
    飞书表格中的 PUSH_SUCCESSS按实现纠正为 PUSH_SUCCESS,见订单推送。
    退款示例中的 refund_client_tsn按参数表和实现纠正为 refund_request_no,见服务端退款。
    退款号长度按已核对的 31 字符限制说明。
    1 / 5 / 30 / 600 秒重试间隔仅用于平台回调通知重试,不能作为支付请求重发策略。

    已知实现限制

    • 查询路径: /mis/query 在入口已注册,但原文核对的 frontend-proxy 没有对应实现。因此本组文档使用已核对的 /upay/v2/query。
    • 取消通知覆盖: tradePush 的 cancel_notify_url 在部分通联/KPay 转发路径未传递,不承诺所有设备均可收到取消通知。按目标设备与路由验证取消通知,并结合查单核实最终结果。

    联调与上线前待确认

    待确认项确认方所需证据
    测试环境与凭证、真实扣款边界、商户 SGD 配置平台接入团队环境清单与可重复的测试样例。
    机型/固件、pay_type 映射、退款与撤销能力设备与渠道负责人目标设备的成功、失败、处理中用例。
    激活码有效期、重新激活、签到频率和公钥轮换终端与平台负责人当前开户说明及目标环境验签样本。
    退款期限、跨店权限、手续费、资金结算及对账渠道/商户运营当前合同、配置和账单样例。
    频控、业务确认时限、取消通知覆盖、交班完成确认平台与设备负责人配置或实测证据;不从本地默认实现推定线上 SLA。

    原文覆盖核对

    2026-11-12 对照原始 HTML 文档核查中英文版本,覆盖每种语言的 26 个带锚点章节、方案概览、26 张表格(含表头共 197 行)以及 34 个代码/示例块(含可下载的 Python 源码)。未发现接口章节、参数表或代码示例缺失;现有接入步骤图已保留三个阶段、八个步骤。

    原文章节当前位置
    overview、方案概览、scope、quickstart、terms、prerequisites快速开始
    integration-journey、integration-flow、best-practices、response-states、reliability业务指南
    auth-signing、auth-callback、notify、notification-details、signature-summary签名与通知
    activate、checkin、pushorder、mis-refund、refund、query、settlement、close激活、签到、推单、设备退款、服务端退款、查单、交班、关单
    errors、testing测试与排障
    sources维护依据与待确认项

    补回适用范围与回调示例中的来源/核验范围链接,将纯文本支付流程与订单状态主路径整理为 Mermaid,保留受理与支付成功的区别、查单恢复及退款能力边界。本次为文档对照,不代表重新核验后端源码或目标环境能力。

    修订记录

    • 2026-10-22,原文修订: 补充首笔交易、四层结果判定、异常恢复、错误码与测试清单;修正重试订单号、退款号语义、回调原文验签/应答/去重、签到响应密钥、退款和交班能力边界。原文保留既有章节锚点与中英切换,仅修改文档,不改变任何 API 行为。

    • 2026-11-11,补齐 Markdown 板块: 恢复原文的维护依据、代码核对范围、差异记录、实现限制及待确认事项,保留本页 sources 锚点,并提供中英文版本。未重新验证目标环境或改变 API 行为。

    • 2026-11-12,原文核对与流程图补充: 按指定原文地址核查覆盖范围,恢复来源跳转,并同步补充中英文支付与订单状态 Mermaid 图。