批量订单查询API

接口说明

批量查询支付交易接口的订单支付处理结果。

共享签约的查询,即商户通过与其他商户的合作关系,查询其合作商户的订单。在这里,商户称为主调商户,其合作商户为下游商户。


数据格式

请求网易支付查询单笔订单的接口采用统一的参数定义规则:

参数

参数名称

长度

必填

样例

sign

根据msg和算法签名后的字符

String


msg

消息体,根据业务参数列表,拼装而成的消息体

String


msgType

消息类型,XML,JSON

String

XML

platformId

商户平台号

String


比如:https://api.epay.163.com/api/batch_trade_query_by_page.htm?msg=&sign=&msgType=&platformId=,其中msg、msgType、platformId和sign是必填参数。msgType:XML或者JSON。如果有特殊字符为避免请求被转码等问题,每个参数发送时需进行UrlEncode.

示例(采用标准XML协议,所有参数只存在一级节点中,不采用多级节点嵌套)

<?xml versi_"1.0"_ encoding=_"UTF-8"_ ?>
<epay>
 <version>1.0.0</version>
 <action>batch_trade_query_by_update_time</action>
 <platformId>2008122815PT00000025</platformId>
 <tradeTime>20120801000000</tradeTime>
 <tradeStatus>0</tradeStatus>
 <pageNo>5</pageNo>
 <pageSize>50</pageSize>

</epay>


请求URL

https://api.epay.163.com/api/batch_trade_query_by_page.htm?

msg=PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48ZXBheT48dmVyc2lvbj4xLjA8L3ZlcnNpb24+PHNpZ25fdHlwZT5yc2E8L3NpZ25fdHlwZT48Z29vZHNfbmFtZT7lvannpag8L2dvb2RzX25hbWU+PGdvb2RzX3VybD5odHRwOi8vY2FpcGlhby4xNjMuY29tL29yZGVyL3ByZUJldF9zc3EuaHRtbDwvZ29vZHNfdXJsPjx0cmFkZV9hbW91bnQ+MC4wMTwvdHJhZGVfYW1vdW50PjxwbGF0Zm9ybV9pZD4yMDA4MTIyODE1UFQwMDAwMDAyNTwvcGxhdGZvcm1faWQ+PHBsYXRmb3JtX3RyYWRlX2lkPjIwMTIwNzAzMTdDUDAwMDAwMDAxPC9wbGF0Zm9ybV90cmFkZV9pZD48cGxhdGZvcm1fdXNlcl9pcD4xMjcuMC4wLjE8L3BsYXRmb3JtX3VzZXJfaXA+PHRyYWRlX3R5cGU+MTwvdHJhZGVfdHlwZT48cGxhdGZvcm1fdHJhZGVfdGltZT4yMDEyMDgwMiAxODoxMTowMDwvcGxhdGZvcm1fdHJhZGVfdGltZT48bm90aWZ5X3VybD5odHRwOi8vY2FpcGlhby4xNjMuY29tL29yZGVyL3ByZUJldF9zc3EuaHRtbDwvbm90aWZ5X3VybD48dGltZW91dD4xMjA8L3RpbWVvdXQ+PHBsYXRmb3JtX3ByaXZhdGVfZmllbGQ+dGVzdDwvcGxhdGZvcm1fcHJpdmF0ZV9maWVsZD48L2VwYXk+&msgType=xml&sign=123 &platformId=2014110517PT83256311


查询参数

参数

参数名称

必填 

长度 

样例

version

版本号

8

1.0.0

action

操作名称

30

参数值为batch_trade_query_by_update_time(表示按照订单最后更新时间查询)或batch_trade_query_by_platform_time 
  
(表示按照商户生成订单的时间查询)

platformId

平台ID

40

2008122815PT00000025   (原样返回)

tradeTime

交易时间

19

20120802000000 (精确到秒,查询从该时间开始24小时的数据)
  
actionbatch_trade_query_by_update_time,该参数表示订单更新时间

tradeStatus

交易状态

30

未付款 
  1 
已付款,等待卖家发货 
  2 
已发货 
  3 
交易成功 
  4 
退款处理中 
  5 
已退款 
  6 
交易关闭

pageNo

分页号码

8

(从1开始默认每页显示20条记录)

pageSize

每页数据展示条数

8

20 (从1开始,最大值为200 
  
如果不填该参数则默认每页显示20条记录)

callerPlatformId 

共享签约主调商户号 


2014110517PT83256311(当传入该参数时,表示使用共享签约查询,platformId为下游商户号)。 共享签约见名词解释


返回参数

参数

参数名称

是否为空

样例

msg

处理结果报文 

如果查询失败为空 

PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiIHN0YW5kYWxvbmU9In   

sign

Msg签名信息

如果查询失败为空 

Y1tn97FXldNeUs3+jiGoPn  

operationCode 

返回码

不为空

0000

errorMsg

错误内容

如果查询失败, 
  
错误详细信息, 
  
查询成功为空

msg_is_null

Msg中的参数说明

参数

参数名称

样例

currentPage

当前页数

1

currentCount

当次查询总条数

18

totalPage

总页数

1

sellerId

卖出方ID,原样返回

print@wyb.163.com

payAccountId

付款方ID,原样返回

printtest@163.com

platformId

平台ID,原样返回

2008122815PT00000025   

platformTradeId 

平台交易流水号 ,原样返回

2012070317CP00000001   

ewTradeId

网易支付交易流水号

2012080317JY49912792   

ewTime

网易支付交易时间 精确到秒, 
  
格式yyyyMMddHHmmss

20120807000000

tradeType

交易类型(1:即时、2:担保),原样返回

1

platformTime

平台商品交易时间 精确到秒, 
  
原样返回 格式:yyyyMMdd HHmmss

20120806000000

tradeStatus

未付款 
  1 
已付款,等待卖家发货 
  2 
已发货 
  3 
交易成功 
  4 
退款处理中 
  5 
已退款 
  6 
交易关闭

0

tradeAmount

交易金额 格式:0.00,平台声明应支付的金额

0.01

trueAmount

实际交易金额 格式0.00,用户实际支付金额

0.01

currencyType

交易币种,人民币:00

00

tradeMode

交易模式,C2C,B2C

1

handFee

手续费;如果产品指定手续费,这里原样返回, 如果是钱包收取,这里返回的是钱包收取的实际手续费。 

0.00

logisticType

物流类型 
  0:
虚拟 
  1:
平邮 
  2:
快递

0

realPayMethod

支付方式

quickpay