查询
查询说明
通过查询接口来确认交易订单状态(成功/失败/待处理/待确认)。当网站的订单状态与支付平台的状态不一致,如掉单(订单在我司商户后台已付款状态,而在商户网站中仍是待付款状态),就可以使用该查询接口,对网站订单状态进行修正。提交参数必须以表单格式提交,查询后以 json 格式返回。在开发查询接口前请把查询交易电脑对外 IP 提交给我们进行登记。
查询地址:
查询提交(以表单格式提交)
| 参数名 | 类型 | 最大长度 | 描述 |
|---|---|---|---|
| merNo | String | 5 | 【商户号】 |
| gatewayNo | String | 8 | 【网关接入号】 |
| orderNo | String | 1000 | 【商户订单号】 网站上的订单号,可以最大查询 100 笔交易。请使用" , " 分隔开。 |
| signInfo | String | 64 | 【数字签名信息】 对提交参数进行组合,然后再进行 sha256 方法签名,具体参数组合顺序如下明文签名结构: (merNo + gatewayNo + signkey); 返回数据为大写.各语言签名方式可能有所不同. |
查询返回
查询返回正式交易的参数列表(json 数据)
| 参数名称 | 类型 | 描述 |
|---|---|---|
| merNo | String | 【商户号】 |
| gatewayNo | String | 【网关接入号】 |
| orderNo | String | 【商户订单号】 |
| tradeNo | String | 【流水订单号】 |
| tradeDate | String | 【交易时间】 格式: yyyyMMddHHmmss |
| tradeAmount | String | 【交易金额】 |
| tradeCurrency | String | 【交易币种】 |
| sourceWebSite | String | 【交易网站】 |
| queryResult | String | 【交易结果】 -2:待确认 -1:待处理 0 : 失败 1 : 成功 2 : 订单不存在 5 : 3D 失败 |
| returnStatus | String | 1 : 成功返回 3 : 传入的参数不完整 4 : 订单查询过多,(最多只能查询 100 笔) 5 : 商户号或者网关接入号不存在 6 :signInfo 签名信息错误 7 :你方服务器 IP 未登记 999: 系统异常 |
| dealDate | String | 【处理时间】 格式:yyyy-MM-dd HH:mm:ss |
| cardType | String | 【卡种】 1:Visa 2:Master 3:JCB 4:AE |
| resultInfo | String | 【银行返回信息】 |
| isRefundment | String | 【退款状态】 0:未退款 1:已退款 |
| isProtest | String | 【拒付状态】 0:未拒付 1:已拒付 |
| isExplain | String | 【申诉状态】 -2:未申诉 -1:申诉中 0:失败 1:成功 |
| cardNo | String | 【卡号】 |
| binCountry | String | 【真实发卡国】 |
| remark | String | 【备注】 |
查询正式交易返回参数事例:
json
{
"merNo": "10000",
"gatewayNo": "10000001",
"tradeList": [
{
"tradeDate": "20160312142512",
"orderNo": "00001",
"tradeNo": "N2014031214251201436375",
"sourceWebSite": "mytest.com",
"tradeAmount": "323",
"queryResult": "1",
"tradeCurrency": "USD",
"settlementCurrency": "CNY",
"settlementAmount": "4.01",
"dealDate": "2016-07-19 19:25:37",
"cardType": "1",
"resultInfo": "此交易被拒绝,请联系银行",
"tranSettled": "0",
"depositSettled": "0",
"isRefundment": "0",
"isProtest": "0",
"isFreeze": "0",
"isExplain": "0",
"upLoadType": "1",
"email": "pay@pay.com",
"ipAddress": "127.0.0.1",
"cardNo": "441444***4444",
"trackingno": "2424324",
"logWebsize": "http://www.jcex.hk",
"customerName": "test",
"tel": "12306",
"addess": "abc test",
"city": "shenzhen",
"state": "DC",
"zipcode": "123456",
"country": "US",
"isCrossTrade": "0",
"isHighRiskCountry": "",
"binCountry": "",
"ipCountry": "",
"ipCountryCode": "",
"ipCity": "sz",
"remark": "测试"
}
// . . . . . .
],
"returnStatus": "1"
}