文档首页> 合作伙伴中心> API参考> 管理交易> 管理客户账户> 回收客户账户余额
更新时间：2022-11-01 GMT+08:00
查看PDF
分享

回收客户账户余额

功能介绍

当客户不再使用华为云产品时，合作伙伴可以回收代售类客户账户余额。

伙伴登录伙伴中心回收代售类客户账户余额请参见这里。

接口约束

该接口只允许使用合作伙伴AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/accounts/partner-accounts/reclaim

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customer_id

是

String

最大长度：64

客户账号ID。您可以调用查询客户列表接口获取customer_id。

amount

是

BigDecimal

-

回收的金额。

单位：元。取值大于0且精确到小数点后2位。

indirect_partner_id

否

String

最大长度：64

云经销商ID。获取方法请参见查询云经销商列表。

云经销商（二级经销商）回收云经销商（二级经销商）的子客户账户余额时，需携带此参数；除此之外，该参数不做处理；否则只能回收自己的子客户账户余额。

请求示例

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"
}

状态码

  • 状态码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

其他错误。
父主题： 管理客户账户
分享：

    相关文档

    相关产品