当用户对订单进行撤销操作时,第三方接入商调用安能开放平台的撤销订单接口,订单 在”已开单”前,才可以撤销成功。
当用户对订单进行撤销操作时,第三方接入商调用安能开放平台的撤销订单接口,订单 在”已开单”前,才可以撤销成功。
(1)、安能开放平台会校验撤销订单的请求来源是否为订单所在的第三方接入商,不支持一个接入商撤销另一个接入商的订单。
(2)、撤销订单只能在开单之前才能进行,建议第三方接入商在调用此接口前先判断订单状态。未受理、已受理、已拒绝状态均能撤销成功。撤销成功后,订单状态为已撤销。
入参
序号 |
参数名 |
参数说明 |
数据类型 |
必填 |
备注 |
---|---|---|---|---|---|
1 |
params |
Json字符串 |
String |
是 |
Json字符串,具体见下面params参数说明 |
2 |
timestamp |
时间戳 |
String |
是 |
当前时间对应的时间戳 |
3 |
digest |
签名摘要 |
String |
是 |
base64(MD5(params +code + AppSecret)) |
4 |
code |
客户ID |
String |
是 |
客户唯一ID简码大写字母(订单头) |
Params 入参数据
参数名 |
参数说明 |
最大长度 |
类型 |
必填 |
备注 |
|
---|---|---|---|---|---|---|
1 |
orderNo |
订单号 |
64 |
String |
是 |
|
2 |
remark |
备注 |
200 |
String |
否 |
|
3 |
orderStatus |
状态 |
2 |
int |
是 |
-1为撤消、0为重新提交 |
参数params值示例:
{
"orderNo": "XH20160309110229",
"orderStatus": 0
}
出参
序号 |
参数名 |
参数说明 |
数据类型 |
是否必填 |
备注 |
---|---|---|---|---|---|
1 |
result |
返回结果 |
boolean |
是 |
成功:true;失败:false |
2 |
resultCode |
返回码 |
String |
是 |
见码表说明 |
3 |
resultInfo |
返回信息 |
String |
否 |
|
4 |
reason |
原因 |
String |
否 |
|
成功返回数据的结构示例:
{"result":true,"resultCode":"1000","resultInfo":"成功","reason":"成功"}
失败返回数据的结构示例:
{"result":false,"resultCode":"2002","resultInfo":"数据安全错误","reason":"摘要验证错误"}