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/api/close.md.
  • 简体中文
  • 关单/撤销

    关闭尚未完成支付的订单。当前通联/KPay 路径默认拒绝已明确为 PAID 的订单;已支付订单的资金退回应使用已开通的退款流程。关单与支付并发时仍须查单确认结果。

    接口信息

    • 接口地址: POST https://api.aimt-horizon.com/mis/close
    • 签名凭证: 使用 terminal_sn + terminal_key

    请求参数

    参数类型是否必填说明
    terminal_snString(32)是终端序列号
    out_trade_noString(32)是商户订单号(来自原始 tradePush 订单)
    cancel_reasonString(20)是撤销原因,最多 20 个字符
    target_device_idString(20)是目标支付设备 ID
    cancel_notify_urlString(128)否撤销结果通知的回调地址
    biz_sourceString否业务来源,默认为 "mis"
    client_ipString否请求方 IP 地址

    请求示例

    {
      "terminal_sn": "2101107140290972547",
      "out_trade_no": "SG20261022001",
      "cancel_reason": "Customer cancelled",
      "target_device_id": "TUSN12345678",
      "biz_source": "mis"
    }

    响应示例(受理,仍需查单)

    {
      "result_code": "200",
      "error_message": null,
      "error_code": null,
      "biz_response": {
        "result_code": "MIS_PUSH_SUCCESS",
        "error_code": null,
        "error_message": null
      }
    }

    响应示例(失败)

    {
      "result_code": "200",
      "error_message": null,
      "error_code": null,
      "biz_response": {
        "result_code": "MIS_PUSH_FAIL",
        "error_code": "TERMINAL_SN_UN_BIND",
        "error_message": "Terminal SN is unbound, push failed"
      }
    }
    注意
    • 先查原订单;查单后仍可能完成付款,关单提示已支付时应重新查单。未支付订单也受预撤单条件、渠道和设备能力限制;MIS_PUSH_SUCCESS 仅表示受理,不能直接将本地订单标记为已撤销。
    • out_trade_no 必须与通过 tradePush 推送的原始订单一致。
    • ORDER_CLOSE_ABORT_IN_PROGRESS 表示关单仍在处理;PAY_TYPE_CANCEL_NOT_SUPPORTED 时按设备提示操作并查单,不盲目改走退款。
    • 向顾客确认前,务必通过回调或查询接口核实撤销结果。