查询订单

1) 俗称勾兑或对账,通过查询接口来确认进行交易复查的操作。

2) 当您网站上出现掉单情况(在我司商户后台查看是已付款状态,在你网站上却仍是待付款状态)可以使用这个查询接口,对网站异常订单状态进行修正。

3) 服务器IP需登记,请联系技术支持。

 

1 提交参数

示例代码:

<input  type="hidden"  name="merNo" value="99999" />
<input  type="hidden"  name="gatewayNo" value="99999001" />
<input  type="hidden"  name="orderNo" value="00001,00002,00003" />
<input  type="hidden"  name="singInfo" value="4b15sge2cbb90fddrpidf434fsdffa2" />

 

参数名

类型

长度

是否必填

描述

merNo

String

5

Yes

【商户号】

gatewayNo

String

8

Yes

【网关接入号】

orderNo

String

1000

Yes

【商户订单号】
网站上的订单号,可以最大查询100笔交易。
请使用" , " 分隔开。

signInfo

String

64

Yes

【签名数据】
全为小写,各语言加密方式不同,
详见【附录】sha256加密方式
明文加密结构:merNo + gatewayNo + signkey

 

2 返回参数

当你提交N笔OrderNo的时候,我们则会返回以下N条记录。

参数名

类型

长度

是否必填

描述

merNo

String

【商户号】

gatewayNo

String

【网关接入号】

orderNo

String

【商户订单号】

tradeNo

String

【流水订单号】

tradeDate

String

【交易时间】
格式: yyyyMMddHHmmss

tradeAmount

String

【交易金额】

tradeCurrency

String

【交易币种】

sourceWebSite

String

【交易网站】

authStatus

String

【授权状态】
返回数字:0/1/2/3
0: 未使用授权
1: 授权失败
2: 待处理
3: 授权成功

queryResult

String

【交易结果】
返回数字: -2/-1/0/1/2/3/4/5/6/7/999
-2:待确认
-1:待处理
0 : 失败
1 : 成功
2 : 订单不存在
3 : 传入的参数不完整
4 : 订单查询过多,(最多只能查询100笔)
5 : 商户号或者网关接入号不存在
6 :signInfo 加密信息错误
7 :你方服务器IP未登记
999: 系统异常

 

返回样例

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <tradeinfo>
    <merNo>99999></merNo>     
    <gatewayNo>99999003</gatewayNo>
    <tradeNo>2014xxxxxxxxxx</tradeNo>
    <tradeDate>20150519165736</tradeDate>
    <tradeAmount>98</tradeAmount>
    <tradeCurrency>USD</tradeCurrency>
    <sourceWebSite>http://bai.com/result.php</sourceWebSite>
    <authStatus>0</authStatus>
    <queryResult>1</queryResult>
    <barcode>10001</barcode>
    <paytime>2015-05-19 16:57:36</paytime>
    <clearStatus>1</clearStatus>
    <orderDetails>
      <OrderDetail id=”1”>
        <subOrderNo>123456789</subOrderNo>
        <subOrderAmount>98</subOrderAmount>
        <subOrderCurrency>USD</subOrderCurrency>
        <subTradeNo>2012099999999999999999</subTradeNo>
        <subSignInfo>jdfj0082j54bh4sgf9he88r7xjshgchagj</subSignInfo>
      </OrderDetail>
      <OrderDetail id=”2”>
      ……
      </OrderDetail>
    </orderDetails>
  </tradeinfo>
</response>