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