订单关闭接口|京东聚合支付开发者文档

1. 接口介绍
商户查询订单状态（退款订单）接口提供给商户向聚合支付服务发送退款订单状态查询请求数据集合，聚合支付服务会根据请求数据验证商户身份，以及验证请求信息是否被篡改。验证通过后，聚合支付服务会返回订单状态信息。
应用场景：常用于刷卡付，签约扣款。
备注：商户如果调用关闭订单接口进行关单操作，将会使原订单号无法再次进行支付，必须使用新的订单号重新发起支付。使用该接口时，商户需根据具体业务需要选择使用。备注：商户如果调用关闭订单接口进行关单操作，将会使原订单号无法再次进行支付，必须使用新的订单号重新发起支付。使用该接口时，商户需根据具体业务需要选择使用。
```
HTTPS调用地址：https：//apipayx.jd.com/order/close
编码格式： UTF-8
调用方式：POST
数据格式：application/JSON
```
2. 请求参数列表

|序号	|参数名称	|参数编码	|是否必填	|参数类型	|描述|
|---|---|--|--|--|--|
|1|	商户号	|merchantNo|	是	|String(30)	||
|2	|外部订单号	|outTradeNo	|是	|String(100)	||
|3	|交易号	|tradeNo|	是	|String(30)	||
|4	|支付代码|	payCode	|否	|String(20)	|交易返回描述|
|5|	支付消息|	payDesc	|否	|String(100)	|交易返回描述|

3. 返回参数列表

|序号|	参数名称|	参数编码	|是否必填|	参数类型|	描述|
|--|---|--|--|--|--|
|1|	商户号|	merchantNo|	是|	String(32)	||
|2	|外部订单号|	outTradeNo|	是	|String(64)	|
|3|	交易流水号	|tradeNo|	否	|String	||
|4	|订单状态|	payStatus|	否	|String	|CLOSE：交易关闭,<br>REFUND：交易已退款<br>FINISH：交易已完成|
|5	|业务状态	|resultCode	|是|	String|	SUCCESS：关单成功<br>FAIL：关单失败|
|6|	错误代码	|errCode|	是	|String	||
|7|	错误代码描述|	errCodeDes	|否|	String	||

4. 参数特殊说明

```
1) 在以上的请求参数中，商户号是在注册开通聚合支付功能的时候，聚合支付商户管理系统为用户分配的。
2) 外部订单号是商户自己的订单号。
3) 签名规则详见：签名算法
4) 为保证信息安全，表单中的各个字段除了merchant（商户号）、签名（sign）以外，其余字段全部采用3DES进行加密
5. 样例
```

1)源请求字符串样例：

```
{
"merchantNo"："110047938",
"cipherJson" ："cdb9e085d8e5596b81995b01edfc6fa9",
"tradeNo"："144212121444",
"payCode"："212121qqwe2,
"payDesc"："desc"
}
```
2)请求及响应数据集合参数样例：

```
{
"merchantNo"："110047938",
"outTradeNo ："这里的值是对明文源串样例加密得到的值",
"sign"："这里的值是对明文源串样例按照ASCII正序排序后加盐，再用md5
       	加签得到的值"
}
```
        
3) 错误码列表：

|序号	|错误代码	|错误描述|	修正意见|
|---|----|---|---|
|1|	000000	|请求成功	||
|2	|AGGA100000	|网络异常，调用网关失败	网络问题，|可稍后再尝试|
|3	|AGGA000001	|系统内部错误	|请联金融客服|
|4	|AGGA100001	|请求参数不能为空	|请检查参数列表是否正确|
|5	|AGGA100002	|非法请求,解密验签失败	|请确认密钥和盐的正确性，检查加密加签算法|
|6|	AGGT9990001|	未知错误|	请稍后重试|
|7	|AGGT9990002	|未知错误，应该是网络异常	|请稍后重试|
|8	|AGGT9990003	|方法调用非法	|请稍后重试|
|9	|AGGT9990004	|数据转换异常|	请稍后重试|
|10|	AGGT0101900	|数据库操作异常|	请稍后重试|
|11	|AGGT1000400	|请求数据不合法|	请检查参数列表|
|12	|AGGT0001001	|数据库没有数据|	请稍后重试|
|13	|AGGT0101900	|数据库操作异常|	请稍后重试|
|14	|AGGT3001203	|无此交易信息	||
|15|	AGGT3001213|	无原交易信息||	
|16	|AGGT3001234	|交易已关单	||
|17|	AGGG100000|	参数校验失败	||
|18|	AGGG100004	|参数:XXX不能为空|	|
|19	|AGGG777777	|系统处理异常	|请联金融客服|
|20	|AGGG999999|系统处理错误	|请联金融客服|
4)返回密文串样例
```
{

"success"："当调用成功时返回true",
"errCode"："调用失败时返回错误原因店代码"
"errCodeDes"："错误描述"
"merchantNo"："110047938"，
"cipherJson"："这里的值是返回明文串加密得到的值"，
"sign"："这里的值是对返回明文串按照ASCII正序排序后加盐， 再用md5加签得到的值"   
}
```
5)解密cipherJson字段后：
注意：请先对明文验签成功再解析业务内容
```
{

"resultCode"："请先判断此字段返回值，再根据业务需要进行相应处理"，
"errCode"："业务处理异常时的错误代码"，
"errCodeDes"："业务处理异常时的详细描述"，
"merchantNo"："110047938"，
"outTradeNo"："110047938000000000"，
"tradeNo"："110047938000000000"，
"payStatus"："SUCCESS"，
"requestVersion"："V1.0.0"
}
```