业务功能
根据商户订单号来关闭商户已经生成的订单，主要用于顾客扫生成的二维码订单。
交互模式
后台系统调用交互模式
请求 url：https://pay.xrtpay.cn/xrtpay/gateway
通过 POST XML 内容体进行请求
文档版本：
| 版本号 |
修定人 |
制定日期 |
修订日期 |
| 1.0.0 |
Eric.Yang |
2020-07-14 |
2019-12-10 |
请求参数列表
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 接口类型 |
service |
是 |
String(32) |
unified.trade.close |
| 版本号 |
version |
否 |
String(8) |
默认值是2.0。 |
| 字符集 |
charset |
否 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值：MD5 默认：MD5 |
| 商户号 |
mch_id |
是 |
String(32) |
商户号， 由技术人员分配 |
| 商户订单号 |
out_trade_no |
否 |
String(32) |
商户系统内部的订单号, out_trade_no |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串， 不长于 32 位 |
| 签名 |
sign |
是 |
String(32) |
MD5 签名结果，详见“数字签名 MD5 签名规则” |
返回结果
数据按 XML 的格式实时返回
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 版本号 |
version |
是 |
String(8) |
默认值是 2.0。 |
| 字符集 |
charset |
是 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值： MD5 默认： MD5 |
| 返回状态码 |
status |
是 |
String(16) |
0 表示成功非 0 表示失败此字段是通信标识， 非交易标识， 交易是否成功需要查看 trade_state 来判断 |
| 返回信息 |
message |
否 |
String(128) |
返回信息， 如非空，为错误原因签名失败参数格式校验错误 |
| 业务结果 |
result_code |
是 |
String(16) |
0表示成功，非0表示失败；0表示关单成功，此笔订单不能再发起支付；非0或其它表示关单接口异常，可再次发起关单操作 |
| 商户号 |
mch_id |
是 |
String(32) |
商户号， 由技术部分配 |
| 设备号 |
device_info |
否 |
String(32) |
终端设备号 |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串， 不长于 32 位 |
| 错误代码 |
err_code |
否 |
String(32) |
具体错误码请看文档最后错误码列表 |
| 错误代码描述 |
err_msg |
否 |
String (128) |
结果信息描述 |
| 签名 |
sign |
是 |
String(32) |
MD5 签名结果， 详见“数字签名 MD5 签名规则” |
文档更新时间: 2021-03-06 11:16 作者：EricYang
