文档首页/ 合作伙伴中心/ 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

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

相关文档