> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt. # 关单/撤销 关闭尚未完成支付的订单。当前通联/KPay 路径默认拒绝已明确为 PAID 的订单;已支付订单的资金退回应使用已开通的退款流程。关单与支付并发时仍须查单确认结果。 ## 接口信息 - **接口地址:** POST `https://api.aimt-horizon.com/mis/close` - **签名凭证:** 使用 terminal_sn + terminal_key ## 请求参数 | 参数 | 类型 | 是否必填 | 说明 | | ------------------- | ----------- | ---- | ------------------------ | | `terminal_sn` | String(32) | 是 | 终端序列号 | | `out_trade_no` | String(32) | 是 | 商户订单号(来自原始 tradePush 订单) | | `cancel_reason` | String(20) | 是 | 撤销原因,最多 20 个字符 | | `target_device_id` | String(20) | 是 | 目标支付设备 ID | | `cancel_notify_url` | String(128) | 否 | 撤销结果通知的回调地址 | | `biz_source` | String | 否 | 业务来源,默认为 "mis" | | `client_ip` | String | 否 | 请求方 IP 地址 | ## 请求示例 ```json { "terminal_sn": "2101107140290972547", "out_trade_no": "SG20261022001", "cancel_reason": "Customer cancelled", "target_device_id": "TUSN12345678", "biz_source": "mis" } ``` ## 响应示例(受理,仍需查单) ```json { "result_code": "200", "error_message": null, "error_code": null, "biz_response": { "result_code": "MIS_PUSH_SUCCESS", "error_code": null, "error_message": null } } ``` ## 响应示例(失败) ```json { "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" } } ``` :::warning 注意 - 先查原订单;查单后仍可能完成付款,关单提示已支付时应重新查单。未支付订单也受预撤单条件、渠道和设备能力限制;MIS_PUSH_SUCCESS 仅表示受理,不能直接将本地订单标记为已撤销。 - out_trade_no 必须与通过 tradePush 推送的原始订单一致。 - ORDER_CLOSE_ABORT_IN_PROGRESS 表示关单仍在处理;PAY_TYPE_CANCEL_NOT_SUPPORTED 时按设备提示操作并查单,不盲目改走退款。 - 向顾客确认前,务必通过回调或查询接口核实撤销结果。 :::