关闭订单

我的收藏

使用限制

无

接口说明

可用于关闭用户待支付订单。

请注意仅支持待支付订单关单，已支付、超时未支付订单无法关闭订单，已支付订单请走退款逻辑。

基本信息

基本信息
HTTP URL	https://open.douyin.com/api/apps/trade/v2/order/close_order
HTTP Method	POST
Scope	industry_open.trade.order_common
权限要求	不需要用户授权

请求头

参考通用参数

请求参数

名称	类型	是否必填	描述	示例值
order_id	string	是	抖音开平内部交易订单号，通过预下单回调传给开发者服务，长度 < 64byte	"ots1230123132123"

请求示例

curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/order/close_order' \
--header 'Content-Type: application/json' \
--header 'access-token: clt.xxx' \
--data-raw='{
    "order_id" : "ots1230123132123"
}'

响应参数

名称	类型	描述	示例值
extra	object	额外信息，参见通用参数

响应示例

正常示例

{
  "extra": {
    "sub_error_code": 0,
    "sub_description": "success",
    "logid": "2022092115392201020812109511046",
    "now": 1663745962686,
    "error_code": 0,
    "description": "success"
  }
}

异常示例

{
  "extra": {
    "sub_error_code": 13000,
    "sub_description": "系统错误",
    "logid": "2022092115392201020812109511046",
    "now": 1663745962686,
    "error_code": 2191000,
    "description": ""
  }
}

错误码

详情参见错误码/返回码。