数据格式
请求网易支付查询单笔订单的接口采用统一的参数定义规则:
参数 | 参数名称 | 长度 | 必填 | 样例 |
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、msgType、platformId和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 | 商品提现日期 | 是 |
withDrawAmount | 提现金额 | 是 |
handlingFee | 手续费 | 否 |
withdrawStatus | 处理状态 (同入参中的提现状态一致) | 是 |
receiveFlag | 银行确认标识 当withdrawStatus=1,且receiveFlag=Y时表示款项已到账,其他情况表示未到账 在一些特殊情况下,此标识不一定100%准确 | 否 |
withDrawBackReason | 提现失败原因 | 否 |
receiveFlag状态说明:
receiveFlag=N或为空,表示尚未收到银行反馈确认。
withdrawStatus=1,receiveFlag=Y 表示银行确认成功。
withdrawStatus=2或5,receiveFlag=Y 表示银行确认失败。
在一些特殊情况下,receiveFlag标识不一定100%准确。