企业主账号向企业子账号拨款优惠券
功能介绍
企业主账号在自建平台向企业子账号拨款优惠券。
- 仅支持华为发放的测试类、商务类、活动类代金券。
接口约束
该接口只允许使用企业主账号AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/enterprises/multi-accounts/transfer-coupon
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
customer_id |
是 |
String |
[1-64] |
企业子账号的客户ID。您可以调用查询企业子账号列表接口，获取响应参数“id”的返回值。 |
amount |
是 |
String |
[1-32] |
总划拨金额。单位为元。 单位：元。取值大于0且精确到小数点后2位。 |
coupon_id |
是 |
String |
[1-64] |
优惠券ID。您可以调用查询企业主账号可拨款优惠券列表接口，获取响应参数“coupon_id”的返回值。 |
trans_id |
否 |
String |
[0-32] |
交易序列号，用于防止重复提交。
此参数不携带或携带值为null或携带值为空串时，由系统自动生成。 |
请求示例
POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/transfer-coupon HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_id": "06a29c********400fc0c01027684d40", "amount": "100.00", "trans_id": "2020042401", "coupon_id": "CP19092406014086E3" }
响应消息
响应参数
状态码：200
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
sub_coupon_id |
String |
最大长度：64 |
子优惠券ID。 |
状态码：400
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
error_code |
String |
最大长度：16 |
状态码。具体请参考状态码。只有失败才会返回这个参数。 |
error_msg |
String |
最大长度：1024 |
错误描述信息。只有失败才会返回这个参数。 |
fail_check_items |
List<String> |
- |
不满足的业务规则检查项。
|
检查项ID |
检查项名称 |
|---|---|
SAME_LEGAL_TRANS_COUPON |
同一法人关联类型才能划拨代金券 |
COUPON_BALANCE_NOT_ENOUGH |
代金券余额小于划拨金额 |
COUPON_TRANS_ONE_TIME |
代金券只能一次性全部划拨 |
ONLY_CASH_COUPON_CAN_TRANSFER |
只有代金券支持在企业主子账号间划拨和回收 |
COUPON_STATUS_CAN_NOT_OPERATE |
优惠券当前不允许操作：状态为不可用、已过期或被冻结 |
COUPON_NOT_EXIST_OR_NOT_PRI |
待划拨的优惠券不存在或不属于企业主账号 |
COUPON_SCENE_CAN_NOT_TRANSFER |
代金券的应用场景不在可划拨范围内 |
COUPON_SOURCE_TYPE_FORBID |
代金券的发券方类型在禁止划拨范围内 |
MUST_BE_SAME_SIGNING_ENTITY |
关联的子账号签约主体与您的账号签约主体不一致，无法操作。 |
NO_TRANSFER_FOR_FC_SUBACCOUNT |
不能给财务托管企业子划拨。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"sub_coupon_id": "CP19092406014086E2"
}
状态码
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
HTTP状态码 |
错误码 |
错误描述 |
|---|---|---|
400 |
CBC.0100 |
参数错误。 |
400 |
CBC.99000043 |
企业主账号向企业子账号拨款/回收失败。 |
400 |
CBC.99007004 |
发起的业务操作存在不满足的业务检查项。 |
400 |
CBC.99007009 |
交易事务ID重复。 |
403 |
CBC.0151 |
访问拒绝。 |
403 |
CBC.0155 |
不允许执行当前请求。 |
500 |
CBC.0999 |
其他错误。 |
