# 取消待支付订单-CancelCustomerOrder
#### 功能介绍
客户可以对待支付的订单进行取消操作。
客户登录费用中心取消包年包月产品的待支付订单请单击[这里](https://support.huaweicloud.com/usermanual-billing/order_topic_8000001.html)。
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
只有订单状态是"待支付"的时候，才能取消订单。
#### 接口约束
该接口只允许使用客户AK/SK或者Token调用，不允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=CancelCustomerOrder)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
伙伴操作员账号无法调用当前API。
#### URI
PUT /v2/orders/customer-orders/cancel
#### 请求消息
请求参数
| 参数       | 是否必选 | 参数类型   | 取值范围    | 描述                                                                                                                                                                      |
|:---|:---|:---|:---|:---|
| order_id | 是    | String | 最大长度：64 | 订单ID。 取值为调用"[查询订单列表-ListCustomerOrders](https://support.huaweicloud.com/api-bpconsole/api_order_00013.html)"接口时响应消息中的"order_id"字段的值。 |
   
请求示例
```
PUT https://bss.myhuaweicloud.com/v2/orders/customer-orders/cancel HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "order_id": "CS170926155954NO7"
}
```
#### 响应消息
响应参数
表1响应参数 
| 参数         | 参数类型   | 取值范围     | 描述                                                                                    |
|:---|:---|:---|:---|
| error_code | String | 最大长度：10  | 状态码。 具体请参见[状态码]。 |
| error_msg  | String | 最大长度：256 | 错误描述信息。                                                                               |
   
响应示例:
```
HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
```
 #### 状态码
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 描述                        |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。                     |
| 400     | CBC.99005010 | 订单状态不允许取消。                |
| 403     | CBC.0151     | 访问拒绝。                     |
| 500     | CBC.0999     | 其他错误。                     |
| 400     | CBC.99000089 | 抱歉，当前订单号不能操作，请使用组合交易单号操作。 |