文档首页/ 客户运营能力/ API参考/ 管理企业/ 管理企业多账号/ 企业主账号向企业子账号拨款优惠券
更新时间:2023-11-24 GMT+08:00
分享

企业主账号向企业子账号拨款优惠券

功能介绍

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

  • 仅支持华为发放的测试类、商务类、活动类代金券

接口约束

该接口只允许使用企业主账号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]

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

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

此参数不携带或携带值为null或携带值为空串时,由系统自动生成。

请求示例

POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/transfer-coupon HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...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>

-

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

  • 当错误码为CBC.99007004时返回
  • 具体请参见表1
表1 企业主账号向子账号拨款优惠券检查项

检查项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

其他错误。

相关文档