客户运营能力客户运营能力

文档首页> 客户运营能力> API参考> 管理企业> 管理企业多账号> 企业主账号向企业子账号拨款
更新时间:2021/09/08 GMT+08:00
分享

企业主账号向企业子账号拨款

功能介绍

企业主账号在自建平台向企业子账号拨款。

接口约束

该接口只允许使用企业主账号AK/SK或者Token调用。

调试

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

URI

POST /v2/enterprises/multi-accounts/transfer-amount

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customer_id

String

最大长度:64

企业子账号的客户ID。

amount

String

最大长度:32

现金账户总划拨金额。

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

trans_id

String

最大长度:32

交易序列号,用于防止重复提交。

  • 如果接口调用方不传此参数的值,则系统自动生成。
  • 如果接口调用方传入此参数的值,请采用UUID保证全局唯一。

balance_type

String

最大长度:64

账户类型:

  • BALANCE_TYPE_DEBIT:余额账户(默认)
  • BALANCE_TYPE_CREDIT:信用账户

expire_time

String

最大长度:20

账户到期时间,UTC时间,格式为:2016-03-28T14:45:38Z。

只对信用账户有效,用于限制针对有效期到期时间等于该时间的信用账户余额进行拨款,精确到秒。如果查询信用账户可拨款余额的查询结果没有失效时间,表示永久有效,对于这种账本拨款的情况无需填写。

请求示例

POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/transfer-amount HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "customer_id": "06a29ceaae80d2400fc0c01027684d40",
  "amount": "100",
  "trans_id": "2020042401",
  "balance_type": "BALANCE_TYPE_DEBIT",
  "expire_time": "2020-05-28T14:45:38Z"
}

响应消息

响应参数

状态码:204

默认返回:Success

状态码:400

参数

参数类型

取值范围

描述

error_code

String

最大长度:16

状态码。具体请参考状态码。只有失败才会返回这个参数。

error_msg

String

最大长度:1024

错误描述信息。只有失败才会返回这个参数。

fail_check_items

List<String>

-

不满足的业务规则检查项:

表1 企业主账号向子账号拨款或回收检查项

检查项ID

检查项名称

SUB_CUSTOMER_NO_OWN_CREDIT

企业子账号自己已有信用额度,不允许划拨信用额度。

NO_SHARE_CREDIT_TO_SUB_PERMISSION

子账号没有授予主账号“子账号共享主账号信用额度”权限,不能划拨或回收信用额度。

TRANS_CREDIT_EXT_PRI_MUST_POSTPAY

外部客户的主账号必须是后付费才能划拨信用额度给子账号。

PRI_RESALE_BP_SUB_CUST_NOT_TRANS_CREDIT

企业主账号是分销商转售模式的子客户,不允许给子账号划拨信用额度。

ADVANCE _PAY_PRI_SUB_MUST_SAME_LEGAL

伙伴垫付场景下,仅允许企业客户将垫付资金划拨给相同法人的子账号。

响应示例

HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 

状态码

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.99000043

企业主账号向企业子账号拨款/回收失败。

400

CBC.99005003

余额不足。

400

CBC.99007004

发起的业务操作存在不满足的业务检查项。

400

CBC.99007009

交易事务ID重复。

400

CBC.99007181

划拨或回收的信用额度的有效期已过期。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品