接口说明
查询支付接口的单笔订单支付处理的结果。最优查询时间及频率详见【交易超时查询机制最佳实践】
共享签约的查询，即商户通过与其他商户的合作关系，查询其合作商户的订单。在这里，商户称为主调商户，其合作商户为下游商户。
数据格式
请求网易支付查询单笔订单的接口采用统一的参数定义规则：
参数 | 参数名称 | 长度 | 必填 | 样例 |
sign | 根据msg和算法签名后的字符 | String | 是 | |
msg | 消息体，根据“业务参数”列表，拼装而成的消息体 | String | 是 | |
msgType | 消息类型，XML,JSON | String | 是 | XML |
platformId | 商户平台号 | String | 是 |
比如：https://api.epay.163.com/api/single_trade_query.htm?msg=&sign=&msgType=，其中msg、msgType和sign是必填参数。msgType：XML或者JSON。所有参数只存在一级节点中，不采用多级节点嵌套。
示例（业务参数拼装成XML格式）
<?xml versi_"1.0"_ encoding=_"UTF-8"_ ?> <epay> <version>1.0.0</version> <action>single_trade_query</action> <platformId>2008122815PT00000025</platformId> <platformTradeId>2012070317CP00000001</platformTradeId> <platformTradeDate>20120802</platformTradeDate> </epay> |
请求URL
https://api.epay.163.com/api/single_trade_query.htm? msg=PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48ZXBheT48dmVyc2lvbj4xLjA8L3ZlcnNpb24+PHNpZ25fdHlwZT5yc2E8L3NpZ25fdHlwZT48Z29vZHNfbmFtZT7lvannpag8L2dvb2RzX25hbWU+PGdvb2RzX3VybD5odHRwOi8vY2FpcGlhby4xNjMuY29tL29yZGVyL3ByZUJldF9zc3EuaHRtbDwvZ29vZHNfdXJsPjx0cmFkZV9hbW91bnQ+MC4wMTwvdHJhZGVfYW1vdW50PjxwbGF0Zm9ybV9pZD4yMDA4MTIyODE1UFQwMDAwMDAyNTwvcGxhdGZvcm1faWQ+PHBsYXRmb3JtX3RyYWRlX2lkPjIwMTIwNzAzMTdDUDAwMDAwMDAxPC9wbGF0Zm9ybV90cmFkZV9pZD48cGxhdGZvcm1fdXNlcl9pcD4xMjcuMC4wLjE8L3BsYXRmb3JtX3VzZXJfaXA+PHRyYWRlX3R5cGU+MTwvdHJhZGVfdHlwZT48cGxhdGZvcm1fdHJhZGVfdGltZT4yMDEyMDgwMiAxODoxMTowMDwvcGxhdGZvcm1fdHJhZGVfdGltZT48bm90aWZ5X3VybD5odHRwOi8vY2FpcGlhby4xNjMuY29tL29yZGVyL3ByZUJldF9zc3EuaHRtbDwvbm90aWZ5X3VybD48dGltZW91dD4xMjA8L3RpbWVvdXQ+PHBsYXRmb3JtX3ByaXZhdGVfZmllbGQ+dGVzdDwvcGxhdGZvcm1fcHJpdmF0ZV9maWVsZD48L2VwYXk+&msgType=xml&sign=123 |
查询参数
参数 | 参数名称 | 必填 | 长度 | 样例 |
version | 版本号 | 是 | 8 | 1.0.0 |
action | 操作名称 | 是 | 30 | single_trade_query |
platformId | 商户ID，原样返回 | 是 | 40 | 2008122815PT00000025 |
platformTradeId | 商户交易流水号，唯一 | 是 | 40 | 2012070317CP00000001 |
platformTradeDate | 商户商品交易时间 | 否 | 8 | 20120802 |
callerPlatformId | 共享签约主调商户ID，若不为空，则platformId为下游商户ID | 否 | 2014110517PT83256311 | |
| returnQuickpayFailReason | 结果返回订单对应最近快捷支付的失败原因 （订单为未支付或关单时有值）,boolean，默认false | 否 | boolean | false |
返回参数
参数 | 参数名称 | 是否为空 | 样例 |
msg | 处理结果报文 | 如果查询失败为空 | |
sign | Msg签名信息 | 如果查询失败为空 | |
operationCode | 返回码 | 不为空 | 0000 |
errorMsg | 错误内容 | 如果查询失败， 返回错误详细信息；查询成功为空 | msg_is_null |
Msg中的参数说明
参数 | 参数名称 | 样例 |
sellerId | 卖出方ID，原样返回 | print@wyb.163.com |
payAccountId | 付款方ID，原样返回 | printtest@163.com |
platformId | 商户ID，原样返回 | 2008122815PT00000025 |
platformTradeId | 商户交易流水号 ，原样返回 | 2012070317CP00000001 |
ewTradeId | 网易支付交易流水号 | 2012080317JY49912792 |
ewTime | 网易支付交易时间 精确到秒，格式yyyyMMddHHmmss | 20120807000000 |
tradeType | 交易类型( 1：即时、 2：担保、 3：网关支付交易、 4：点卡支付、 5：捐赠、 6：WAP交易)， 原样返回 | 1 |
platformTime | 商户商品交易时间 精确到秒， | 20120806 00:00:00 |
tradeStatus | 0 未付款 | 0 |
tradeAmount | 交易金额 格式：0.00，商户声明应支付的金额 | 0.01 |
trueAmount | 实际交易金额 格式0.00，用户实际支付金额 | 0.01 |
currencyType | 交易币种，人民币：00 | 00 |
tradeMode | 交易模式，B2C :2 | 1 |
handFee | 手续费； | 0.00 |
logisticType | 物流类型 ：0:虚拟 1:平邮 2:快递 | 0 |
quickpayFailErrorCode | 最近一次快捷支付失败错误码 | 014002 |
| quickpayFailErrorMsg | 最近一次快捷支付失败错误文案 | 余额不足 |
| lastPayStatus | 当前请求的支付状态 字段值包含SUCCESS(代表成功)，FAILED(代表失败)，PROCESSING(代表处理中),NOPAID(未支付)四种状态。 | FAILED |
代号 | 解析 |
0000 | 成功 |
1000 | msg参数为空 |
1001 | msgType参数为空 |
1002 | sign参数为空 |
1003 | action为空 |
1004 | version参数为空 |
1005 | signType参数为空 |
1006 | platform _id参数为空 |
1007 | platform_trade_id参数为空 |
1008 | platform_trade_date参数为空 |
1009 | encoding参数为空 |
1010 | 订单时间为空 |
1011 | 开始时间为空 |
1012 | 交易状态为空 |
1013 | PageNo为空 |
1014 | platform_refund_id参数为空 |
1015 | goods_name参数为空 |
1016 | trade_amount参数为空 |
1017 | platform_trade_time参数为空 |
1018 | logistics_type参数为空 |
1019 | order_id参数为空 |
1020 | 货币种类参数为空 |
1021 | 交易类型参数为空 |
1022 | PLATFORM_PAY_TIME参数为空 |
1023 | SELLER_ID参数为空 |
1024 | SELLER_NICK_NAME参数为空 |
1025 | BUYER_NICK_NAME参数为空 |
1026 | NOTIFY_URL参数为空 |
1027 | GOODS_URL参数为空 |
2000 | 系统异常 |
3000 | MSG非法 |
3001 | msg_type不支持 |
3002 | ACTION不支持 |
3003 | VERSION非法 |
3004 | SIGNTYPE非法 |
3005 | ENCODING不支持 |
3006 | 交易状态非法 |
3007 | platform_trade_date非法 |
3008 | pageNo非法 |
3009 | 开始时间非法 |
3010 | 结束时间非法 |
3011 | 退款金额非法 |
3012 | 退款手续费金额非法 |
3013 | 原路退回参数非法 |
3014 | 交易金额非法 |
3015 | logistics_type非法 |
3016 | 货币种类参数非法 |
3017 | 交易种类参数非法 |
3018 | PLATFORM_PAY_TIME非法 |
3019 | BUYER_NICK_NAME非法 |
3020 | TIME_OUT_IS_ILLEGAL非法 |
3021 | GOODS_URL_IS_ILLEGAL非法 |
3022 | PLATFORM_PRIVATE_FIELD非法 |
3023 | SELLER_ID非法 |
3024 | SELLER_NICK_NAME非法 |
3025 | PLATFORM_TRADE_URL非法 |
3026 | PLATFORM_TRADE_ID非法 |
3027 | NOTIFY_URL非法 |
3028 | 商品名非法 |
3029 | 网易支付订单号非法 |
3030 | 商户退款ID非法 |
4000 | 订单不存在 |
4001 | 开始时间、结束时间不能超过一天 |
4002 | platform_id在网易支付不存在 |
4003 | 商户没有该权限 |
4004 | 商户IP没有该权限 |
4005 | 商户提交订单已经支付 |
4006 | 验证签名 |
4007 | 商户不存在 |
4008 | 商户没有设置费率 |
4009 | 订单不是本商户提交的 |
4010 | 订单URL已经过期 |
4011 | 商户提交订单已经关闭 |
4012 | 商户提交订单重复 |
4013 | 文件夹创建失败 |
4014 | 交易状态不合法 |
4015 | 该交易的退款不能原路退回 |
4016 | 申请退款的手续费大于订单支付时的手续费 |
4017 | 退款记录不存在 |
4018 | 该商户退款不退还手续费 |
4019 | 账户明细不存在 |
4020 | 账户余额不足 |
4021 | 传入的bankcode不支持 |
4022 | 卖家账户必须是平台账户 |
4023 | 卖家账户不能是平台账户 |
4024 | 退款订单号已经存在 |
4025 | 没有对应成功的充值记录 |
4026 | 没有充值记录 |