关闭订单API

数据格式

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

参数

参数名称

长度

必填

样例

sign

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

String


msg

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

String


msgType

消息类型,XML,JSON

String

XML

比如:https://api.epay.163.com/close_trade_service.htm?platformId=xxx&msg=&msgType=&sign=,其中platformIdmsgmsgTypesign是必填参数。
*platformId
*商户号,用于商户路由和商户限流,platformId放在http请求的url,其他请求业务参数封装好后放在post参数中;如果有特殊字符为避免请求被转码等问题,每个参数发送时需进行UrlEncode


1 关闭订单交易查询


请求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

示例(msgBase64前的JSON

{

    "version": "1.0.0",

    "action": "close_trade_service",

    "platformId": "2009061117PT25762148",

    "platformTradeId": "2014020714POD00342723",

    "platformTradeTime":"20130720101011"

}


2 关闭订单交易返回结果

返回参数

参数

参数名称

是否为空

msg

处理结果报文

如果查询失败为空

sign

Msg签名信息

如果查询失败为空

operationCode

返回码

不为空

errorMsg

错误内容

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

msg中的参数说明

参数

参数名称

platformTradeId

商户交易流水号,原样返回

orderStatus

订单状态,目前值只取:,表示订单关闭成功

示例(JSON返回格式)

成功返回:

{"errorMsg":"","msg":"eyJwbGF0Zm9ybVRyYWRlSWQiOiIyMDE0MDIwNzE0UE9EMDAzNDI3MjMiLCJvcmRlclN0YXR1cyI6Nn0=","operationCode":"0000","sign":""}

对msg进行Base64.decode(msg)后的报文形式:

{
    "platformTradeId": "2014020714POD00342723",
    "orderStatus": 6
}

错误返回:

{"msg":"","sign":"","operationCode":"2000","errorMsg":"SYSTEM_ERROR"}

3. 错误码

代号 

解析

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 

订单已经是关闭状态