接口说明
批量查询支付交易接口的订单支付处理结果。
共享签约的查询,即商户通过与其他商户的合作关系,查询其合作商户的订单。在这里,商户称为主调商户,其合作商户为下游商户。
请求网易支付查询单笔订单的接口采用统一的参数定义规则:
参数 | 参数名称 | 长度 | 必填 | 样例 |
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小时的数据) |
tradeStatus | 交易状态 | 是 | 30 | 0 未付款 |
pageNo | 分页号码 | 是 | 8 | 1 (从1开始默认每页显示20条记录) |
pageSize | 每页数据展示条数 | 否 | 8 | 20 (从1开始,最大值为200 |
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 | 网易支付交易时间 精确到秒, | 20120807000000 |
tradeType | 交易类型(1:即时、2:担保),原样返回 | 1 |
platformTime | 平台商品交易时间 精确到秒, | 20120806000000 |
tradeStatus | 0 未付款 | 0 |
tradeAmount | 交易金额 格式:0.00,平台声明应支付的金额 | 0.01 |
trueAmount | 实际交易金额 格式0.00,用户实际支付金额 | 0.01 |
currencyType | 交易币种,人民币:00 | 00 |
tradeMode | 交易模式,C2C,B2C等 | 1 |
handFee | 手续费;如果产品指定手续费,这里原样返回, 如果是钱包收取,这里返回的是钱包收取的实际手续费。 | 0.00 |
logisticType | 物流类型 | 0 |
realPayMethod | 支付方式 | quickpay |