查询订单状态(退款订单)接口|京东聚合支付开发者文档

1. 接口介绍
商户查询订单状态（退款订单）接口提供给商户向聚合支付服务发送退款订单状态查询请求数据集合，聚合支付服务会根据请求数据验证商户身份，以及验证请求信息是否被篡改。验证通过后，聚合支付服务会返回订单状态信息
```
HTTPS调用地址：https：//apipayx.jd.com/trade/queryPayTradeStatus
编码格式： UTF-8
调用方式：post
数据格式：application/JSON
```

2. 查询支付状态请求参数列表

|序号	|参数名称|	参数编码	|是否必填|	参数类型	|描述|
|---|
|1	|商户号	|merchantNo	|是	|String(50)	||
|2|	外部订单号	|outTradeNo|	是|	String(30)	||

3. 查询支付状态返回参数列表

|序号	|参数编码	|参数名称	|必填|	类型	|描述|
|--|
|1	|merchantNo	|商户号|	是|	String	||
|2	|outTradeNo	|外部订单号|	是|	String	||
|3	|tradeNo	|交易流水号	|是|	String	||
|4	|currency	|币种|否|	String|	RMB-人民币|
|5	|amount	|交易金额|	否|	Long|	单位：分|
|6	|payFinishTime|	订单完成时间	|否|	String|	格式：yyyyMMddHHmmss|
|7|	|piTypeEnum	|支付方式|	否	|String	|JDPAY-京东、WX-微信、ALIPAY-支付宝|
|8	|payStatus	|订单状态|	否|	String	|PENDING：交易处理中<br>CLOSE：交易关闭<br>FINISH：交易已退款<br>FINISH：交易已完成|
|9	|resultCode	|调用状态|	是|	String(100)|	SUCCESS：查询订单成功<br>FAIL：查询订单失败|
|10	|errCode	|代码	|是	|String(100)	||
|11|	errCodeDes	|消息|	否|	String(100)	||

4. 参数特殊说明
```
1)在以上的请求参数中，商户号是在注册开通聚合支付功能的时候，聚合支付商户管理系统为用户分配的。
2)外部订单号是商户自己的订单号。
3)签名规则详见：签名算法。
4)为保证信息安全，表单中的各个字段除了merchant（商户号）、签名（sign）以外，其余字段全部采用3DES进行加密
```
5. 样例
1)明文源字符串
```
{
"merchantNo"："110047938",
"outTradeNo" ："cdb9e085d8e5596b81995b01edfc6fa9"
}
```
2)支付请求数据集合参数样例
```
{
"merchantNo"："110047938",
"outTradeNo："这里的值是对明文源串样例加密得到的值",
"sign"："这里的值是对明文源串样例按照ASCII正序排序后加盐，再用md5加签得到的值"
}
```
3) 错误码列表：

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

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"
}
```