数据格式
请求网易支付查询单笔订单的接口采用统一的参数定义规则:
参数 | 参数名称 | 长度 | 必填 | 样例 |
sign | 根据msg和算法签名后的字符 | String | 是 | |
msg | 消息体,根据“业务参数”列表,拼装而成的消息体 | String | 是 | |
msgType | 消息类型,XML,JSON | String | 是 | XML |
比如:https://api.epay.163.com/close_trade_service.htm?platformId=xxx&msg=&msgType=&sign=,其中platformId、msg、msgType和sign是必填参数。
*platformId:*商户号,用于商户路由和商户限流,platformId放在http请求的url里,其他请求业务参数封装好后放在post参数中;如果有特殊字符为避免请求被转码等问题,每个参数发送时需进行UrlEncode。
请求URL
https://api.epay.163.com/close_trade_service.htm?platformId=2009061117PT25762148&msg=ewogICAgInZlcnNpb24iOiAiMS4wLjAiLAogICAgImFjdGlvbiI6ICJjbG9zZV90cmFkZV9zZXJ2aWNlIiwKICAgICJwbGF0Zm9ybUlkIjogIjIwMDkwNjExMTdQVDI1NzYyMTQ4IiwKICAgICJwbGF0Zm9ybVRyYWRlSWQiOiAiMjAxNDAyMDcxNFBPRDAwMzQyNzIzIiwKICAgICJwbGF0Zm9ybVRyYWRlVGltZSI6ICIyMDEzMDcyMDEwMTAxMSIKfQ==&msgType=JSON&sign=123 |
调用参数
字段名 | 参数名 | 必传 | 长度 | 样例 |
版本号 | version | 是 | 8 | 1.0.0 |
操作名称 | action | 是 | 30 | close_trade_service |
商户ID | platformId | 是 | 60 | 商户号 |
商户交易流水号 | platformTradeId | 是 | 60 | 唯一 如2014020714POD00342723 |
商户交易时间 | platformTradeTime | 是 | 30 | 格式:yyyyMMddHHmmss |
示例(msg在Base64前的JSON)
{ "version": "1.0.0", "action": "close_trade_service", "platformId": "2009061117PT25762148", "platformTradeId": "2014020714POD00342723", "platformTradeTime":"20130720101011" } |
返回参数
参数 | 参数名称 | 是否为空 |
msg | 处理结果报文 | 如果查询失败为空 |
sign | Msg签名信息 | 如果查询失败为空 |
operationCode | 返回码 | 不为空 |
errorMsg | 错误内容 | 如果查询失败, 给出错误详细信息; |
msg中的参数说明
参数 | 参数名称 |
platformTradeId | 商户交易流水号,原样返回 |
orderStatus | 订单状态,目前值只取:6 ,表示订单关闭成功 |
示例(JSON返回格式)
成功返回:
{"errorMsg":"","msg":"eyJwbGF0Zm9ybVRyYWRlSWQiOiIyMDE0MDIwNzE0UE9EMDAzNDI3MjMiLCJvcmRlclN0YXR1cyI6Nn0=","operationCode":"0000","sign":""} |
对msg进行Base64.decode(msg)后的报文形式:
{ "platformTradeId": "2014020714POD00342723", "orderStatus": 6 } |
错误返回:
{"msg":"","sign":"","operationCode":"2000","errorMsg":"SYSTEM_ERROR"} |
代号 | 解析 |
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 | 交易状态为空 |
1014 | platform_refund_id参数为空 |
1015 | goods_name参数为空 |
1016 | trade_amount参数为空 |
1017 | productStartTime 参数为空 |
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参数为空 |
1041 | productId参数为空 |
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非法 |
3035 | platformId超过长度限制 |
3046 | productId 超过长度限制 |
3059 | 结果不唯一 |
3054 | PLATFORM_TRADE_TIME格式不正确 |
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 | 没有充值记录 |
5210 | 订单找不到 |
5133 | 订单已经是关闭状态 |