发放优惠券
Web UI
一、伙伴可以登录合作伙伴中心查看华为云给其发放的代金券额度，并出于业务拓展需要使用该额度给客户下发代金券，客户使用该代金券购买资源。
- 在伙伴中心左侧的导航栏中，选择“客户业务 > 代金券管理”。
- 选择“代金券额度”页签。
- 选择一条代金券记录，单击“操作”列的“发放”，进入“发放代金券”页面。
- 设置代金券参数，如：代金券面值、最小可用订单额。
单击“显示更多详情”，可以查看代金券额度的使用限制和客户限制。
- （可选）配置代金券适用的云服务类型、云服务产品。
伙伴可以单击“显示高级设置”，配置代金券适用的云服务类型、云服务产品。
- 选择代金券发放的客户。
单击“添加”，添加代金券发放的客户。可一次性选择多个发放客户（不超过10个）。
- （可选）填写“备注信息”。
备注信息仅发券的伙伴可查看，收券方不可查看。伙伴可以在“客户业务 > 代金券管理”页面，单击“操作记录”，查看代金券的备注信息。
- 单击“提交”。
系统提示发放代金券成功。
二、合作伙伴可以登录合作伙伴中心为客户下发所拥有的现金券额度。
- 在伙伴中心左侧的导航栏中选择“客户业务 > 现金券管理”。
- 选择“现金券额度”页签。
- 单击“操作”列的“发放”，进入“发放现金券”页面。
- 设置现金券参数，如“现金券面值”、有效期。
- 选择发放现金券的客户。
单击“添加”，添加现金券发放的客户。可一次性添加多个发放客户（不超过10个）。
- （可选）填写“备注信息”。
备注信息仅发券的伙伴可查看，收券方不可查看。伙伴可以在“客户业务 > 现金券管理”页面，单击“操作记录”，查看现金券的备注信息。
- 单击“提交”。
系统提示发放现金券成功。
REST API
伙伴在伙伴销售平台使用额度为客户发放优惠券。
- 该接口只能给合作伙伴使用，调用的时候必须传递合作伙伴的AK/SK或者Token。
- 调用该接口之前，需通过客户经理联系华为运营人员，为合作伙伴设置优惠券发放额度。
- URI
POST /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons
参数说明请参见下表。
参数
是否必选
取值范围
描述
partner_id
是
最大长度：64
合作伙伴ID（华为分配）。
获取方法请参见如何获取合作伙伴ID（partner_id）。
- 请求消息
参数
是否必选
参数类型
取值范围
描述
quota_id
是
String
最大长度：64
优惠券额度ID。
请从“发放优惠券”接口的响应参数中获取。
customer_id
是
String
最大长度：64
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。
face_value
是
Double
-
代金券面值。
取值大于0且精确到小数点后2位。
valid_time
否
String
最大长度：20
生效时间。
UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。
expire_time
否
String
最大长度：20
失效时间。
UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。
cloud_service_types
否
String
最大长度：512
允许使用的云服务列表，具体请调用查询云服务类型列表接口获取。
多个云服务产品以“,”隔开，最多支持10个。
默认：空（继承额度上的限制）
注意：如果额度上有限制云服务类型列表，优惠券上的限制不能超过额度的限制；如果额度上没有限制，优惠券上可以随意指定云服务类型。
product_ids
否
String
最大长度：512
允许使用的产品列表。
多个产品以“,”隔开，最多支持10个。
默认：空（继承额度上的限制）
注意：如果额度上有限制产品列表，优惠券上的限制不能超过额度的限制；如果额度上没有限制，优惠券上可以随意指定产品ID。
产品ID需要合作伙伴线下获得。
请求示例
POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/promotion-mgr/partner-coupons HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "quota_id": "2018011615520153", "customer_id": "f8231a7d11484dfaaea8b70755680c7e", "face_value": "100", "valid_time": "2018-01-17T11:54:00Z", "expire_time": "2018-01-20T11:54:00Z" }
- 响应消息
参数
参数类型
取值范围
描述
error_code
String
最大长度：16
状态码。
具体请参见4。
error_msg
String
最大长度：1024
错误描述信息。
coupon_id
String
最大长度：64
发放成功的代金券ID。
只有发放成功的时候才有该字段。
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "success", "coupon_id": "CP180117115414HB5I" }
