企业主账号从企业子账号回收拨款(旧)
功能介绍
企业主账号在自建平台回收给企业子账号的拨款。
如果回收的是企业子账户的信用账户,可以回收所有额度;如果回收金额大于子账户信用余额的时候,可能会导致子账户欠费,请慎重选择。
注意事项:
该接口只允许使用企业主账号AK/SK或者Token调用。
URI
POST /v1.0/{domain_id}/customer/account-mgr/retrieve
参数说明请参见下表。
参数 |
是否必选 |
取值范围 |
描述 |
---|---|---|---|
domain_id |
是 |
最大长度:64 |
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 |
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
transId |
否 |
String |
最大长度:64 |
交易序列号,用于防止重复提交。
此参数不携带或携带值为null或携带值为空串时,由系统自动生成。 |
balanceType |
否 |
String |
最大长度:64 |
账户类型: BALANCE_TYPE_DEBIT:余额账户(默认); BALANCE_TYPE_CREDIT:信用账户。 此参数不携带或携带值为null时,默认为余额账户;不支持携带值为空串。 |
subCustomerId |
是 |
String |
最大长度:64 |
企业子账号的客户ID。 |
deductMode |
是 |
String |
最大长度:10 |
资金扣减模式。 1:服务端按金额扣减。 |
totalRetrieveAmout |
是 |
String |
最大长度:32 |
总回收金额。 单位:元。取值大于0且精确到小数点后2位。 |
expireTime |
否 |
String |
最大长度:20 |
账户到期时间,UTC时间,格式为:2016-03-28T14:45:38Z。 暂只对信用账户有效,用于限制针对有效期到期时间等于该时间的信用账户余额进行回收。如果查询信用账户可回收余额的查询结果没有失效时间,表示永久有效,对于这种账本的回收的时候不用填写。 当信用账户存在过期时间,该字段必须携带,不支持携带值为空串或携带值为null,否则回收失败; 当信用账户不存在过期时间,该字段无需携带,不支持携带值为空串,否则回收失败。 |
请求示例
POST https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/retrieve HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "transId": "33", "balanceType": "BALANCE_TYPE_DEBIT", "subCustomerId": "e8a*****b9c", "deductMode": "1", "totalRetrieveAmout": "1.00", "expireTime": "2018-12-31T15:59:59Z" }
响应消息
响应参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
error_code |
否 |
String |
最大长度:16 |
状态码。具体请参考状态码。只有失败才会返回这个参数。 |
error_msg |
否 |
String |
最大长度:1024 |
错误描述信息。只有失败才会返回这个参数。 |
failCheckItems |
否 |
List<String> |
- |
不满足的业务规则检查项:
|
响应示例
HTTP/1.1 204 No Content Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time
状态码
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
- 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。
HTTP状态码 |
错误码 |
错误描述 |
---|---|---|
400 |
CBC.0100 |
参数错误。 |
403 |
CBC.0151 |
访问拒绝。 |
400 |
CBC.99000047 |
账户不存在。 |
400 |
CBC.99005003 |
余额不足。 |
400 |
CBC.99007004 |
发起的业务操作存在不满足的业务检查项。 |
400 |
CBC.99007461 |
您当前存在尚未完成的拨款或回收任务,请稍后再试。 |
500 |
CBC.7181 |
划拨或回收的信用额度的有效期已过期。 |
500 |
CBC.0999 |
其他错误。 |