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

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	|refundedAmount|	已退款金额|	否	|Long	|单位：分|
|7|	payFinishTime	|订单完成时间	|否	|String	|格式：yyyyMMddHHmmss|
|8	|piTypeEnum	|支付方式	|否	|String	|JDPAY-京东、WX-微信、ALIPAY-支付宝|
|9	|payStatus	|订单状态	|否	|String	|PENDING ：交易处理中<br>CLOSE ：交易关闭<br>REFUND ：交易已退款<br>FINISH ：交易已完成|
|10	|resultCode	|调用状态|	是	|String	|SUCCESS：查询订单成功<br>FAIL：查询订单失败|
|11	|errCode	|代码	|是	|String	||
|12|	errCodeDes	|消息|	否	|String	||

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