商户提现查询API

数据格式

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

参数

参数名称

长度

必填

样例

sign

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

String


msg

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

String


msgType

消息类型,XML,JSON

String

XML

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


请求URL

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

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

 

提现订单查询参数

参数名称

参数

必填 

长度 

样例

版本号

version

8

1.0.0

操作名称

action

30

platform_withdraw_query  

商户ID

platformId

40

2008122815PT00000025  

原样返回

商户提现流水号

platformWithDrawId

40

2012070317CP00000001

唯一(如果该字段不为空,只查询一笔,其他查询条件失效)

商户提现交易时间 

 

platformWithDrawDate   

14

格式yyyyMMddhhmmss精确到秒,查询该时间开始24小时内的数据 

(如果platformWithDrawId为空,platformWithDrawDate不能为空)

提现状态

 

withDrawStatus

50

多个状态中间,分割。状态可取值如下:

1:已经成功发送到payments,即已受理

2:失败,不需要退手续费

3:初始化

5:提现失败,已经返还过提现手续费和提现金额给用户

6:提现失败,但是已经返回过手续费 失败原因是 汇付导致的,银联等网关导致 

7:提现失败,网易支付导致

调用平台商户号

callerPlatformId


2014110517PT83256311  

共享签约时需要填主平台商户,(若不为空,则platformId为子平台商户号)


返回参数

参数

参数名称

是否为空

样例

msg

处理结果报文 

如果查询失败为空


sign

Msg签名信息

如果查询失败为空


operationCode

返回码

不为空

0000

errorMsg

错误内容

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

msg_is_null

Msg中的参数说明

参数参数名称是否一定有值
totalCount查询范围内的记录总数
withdraws提现订单列表 
包含多个withdraw子节点


参数

参数名称

是否一定有值 

platformId

商户平台ID

platformWithDrawId

商品提现流水(需保证不会重复)

platformWithDrawDate   

商品提现日期 
  yyyyMMddhhmmss

withDrawAmount

提现金额

handlingFee

手续费

withdrawStatus

处理状态 (同入参中的提现状态一致) 
  1
:已受理 
  2
:提现失败 
  3
:初始化,即未处理  
  ....

receiveFlag银行确认标识
当withdrawStatus=1,且receiveFlag=Y时表示款项已到账,其他情况表示未到账
 在一些特殊情况下,此标识不一定100%准确

withDrawBackReason

提现失败原因


receiveFlag状态说明:
receiveFlag=N或为空,表示尚未收到银行反馈确认。
withdrawStatus=1,receiveFlag=Y 表示银行确认成功。
withdrawStatus=2或5,receiveFlag=Y 表示银行确认失败。
在一些特殊情况下,receiveFlag标识不一定100%准确。