Skip to content

查询

查询说明

通过查询接口来确认交易订单状态(成功/失败/待处理/待确认)。当网站的订单状态与支付平台的状态不一致,如掉单(订单在我司商户后台已付款状态,而在商户网站中仍是待付款状态),就可以使用该查询接口,对网站订单状态进行修正。提交参数必须以表单格式提交,查询后以 json 格式返回。在开发查询接口前请把查询交易电脑对外 IP 提交给我们进行登记。

查询地址:

查询提交(以表单格式提交)

参数名类型最大长度描述
merNoString5【商户号】
gatewayNoString8【网关接入号】
orderNoString1000【商户订单号】
网站上的订单号,可以最大查询 100 笔交易。请使用" , " 分隔开。
signInfoString64【数字签名信息】
对提交参数进行组合,然后再进行 sha256 方法签名,具体参数组合顺序如下明文签名结构:
(merNo + gatewayNo + signkey);
返回数据为大写.各语言签名方式可能有所不同.

查询返回

查询返回正式交易的参数列表(json 数据)

参数名称类型描述
merNoString【商户号】
gatewayNoString【网关接入号】
orderNoString【商户订单号】
tradeNoString【流水订单号】
tradeDateString【交易时间】
格式: yyyyMMddHHmmss
tradeAmountString【交易金额】
tradeCurrencyString【交易币种】
sourceWebSiteString【交易网站】
queryResultString【交易结果】
-2:待确认
-1:待处理
0 : 失败
1 : 成功
2 : 订单不存在
5 : 3D 失败
returnStatusString1 : 成功返回
3 : 传入的参数不完整
4 : 订单查询过多,(最多只能查询 100 笔)
5 : 商户号或者网关接入号不存在
6 :signInfo 签名信息错误
7 :你方服务器 IP 未登记
999: 系统异常
dealDateString【处理时间】
格式:yyyy-MM-dd HH:mm:ss
cardTypeString【卡种】
1:Visa
2:Master
3:JCB
4:AE
resultInfoString【银行返回信息】
isRefundmentString【退款状态】
0:未退款
1:已退款
isProtestString【拒付状态】
0:未拒付
1:已拒付
isExplainString【申诉状态】
-2:未申诉
-1:申诉中
0:失败
1:成功
cardNoString【卡号】
binCountryString【真实发卡国】
remarkString【备注】

查询正式交易返回参数事例:

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