# 回收云经销商账户拨款-ReclaimIndirectPartnerAccount
#### 功能介绍
华为云总经销商（一级经销商）可以回收云经销商（二级经销商）的账户余额。
一级经销商在伙伴中心回收二级经销商账户拨款请参见[这里](https://support.huaweicloud.com/usermanual-bpconsole/dp_120205.html)。
#### 接口约束
该接口只允许使用华为云总经销商的AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ReclaimIndirectPartnerAccount)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。
接口对应的权限项如下：
| 权限项                   | 权限项名称                       |
|:---|:---|
| BPC_ITEM_SALES_020105 | 销售-云经销商-云经销商管理-我的二级分销商列表-回收 |
   
#### URI
POST /v2/accounts/partner-accounts/indirect-partner-reclaim
#### 请求消息
请求参数
| 参数                  | 是否必选 | 参数类型       | 取值范围    | 描述                                                                                                                                                              |
|:---|:---|:---|:---|:---|
| indirect_partner_id | 是    | String     | 最大长度：64 | 云经销商ID。获取方法请参见[查询云经销商列表](https://support.huaweicloud.com/api-bpconsole/espp_00003.html)。                                                                        |
| amount              | 是    | BigDecimal | -       | 回收金额。 华为云总经销商回收的云经销商的账户金额。 说明： 回收金额不能大于云经销商的账户余额。 单位：元。取值大于0且精确到小数点后2位。 |
   
请求示例
```
POST https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/indirect-partner-reclaim HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
     "indirect_partner_id": "05bad7a90700d5bf0ff6c00ae40d0ca0",
     "amount": 0.01
}
```
#### 响应消息
响应参数
| 参数         | 参数类型   | 描述                                                           |
|:---|:---|:---|
| error_code | String | 状态码。具体请参考[状态码]。只有失败才返回该字段。 |
| error_msg  | String | 错误描述信息。只有失败才返回该字段。                                           |
| trans_id   | String | 事务流水ID，只有成功响应才会返回。                                           |
   
响应示例
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
     "trans_id": "RE2007150151010000fd"
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 描述             |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。          |
| 400     | CBC.99000037 | 您没有操作该云经销商的权限。 |
| 400     | CBC.99005003 | 余额不足。          |
| 403     | CBC.0151     | 访问拒绝。          |
| 500     | CBC.0999     | 其他错误。          |