订单查询
查询当前订单状态与支付结果,用于对账与异常处理。
接口信息
- 接口地址: POST
https://api.aimt-horizon.com/upay/v2/query - 签名凭证: 使用 terminal_sn + terminal_key
请求参数
响应关键字段
查询调用场景
- 1. 推送后确认: 推送订单后,查询并确认支付结果。
- 2. 支付状态未知: 发生网络超时或异常时,查询实际状态。
- 3. 退款后确认: 调用退款接口后,查询并确认退款结果。
- 4. 防止单边账: 为操作员提供手动查询按钮。
按商户订单号查询
取得 sn 后优先用它替代 client_sn。通用查询支持原商户下的有效调用终端;目标设备归属错误、尚未创建支付单或权限问题都可能导致查不到,不能直接重新收款。
查询成功且付款成功的字段示例
查询成功也可返回处理中或失败的交易状态;请按四层规则判断。查询某次退款时额外传入原 refund_request_no,预期 type=REFUND,不要把它解释成 PAYMENT。
