客服热线:40010-40088
进入官网

订单撤销

接口介绍

当用户对订单进行撤销操作时,第三方接入商调用安能开放平台的撤销订单接口,订单 在”已开单”前,才可以撤销成功。

业务约束

(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":"摘要验证错误"}