文档首页 > > API参考> 待下线接口> 管理促销> 管理优惠券> 发放优惠券

发放优惠券

分享
更新时间: 2020/06/24 GMT+08:00

功能介绍

合作伙伴可以在拥有的代金券额度范围内为客户下发优惠券。

Web UI

一、伙伴可以登录合作伙伴中心查看华为云给其发放的代金券额度,并出于业务拓展需要使用该额度给客户下发代金券,客户使用该代金券购买资源。

  1. 在伙伴中心左侧的导航栏中,选择“客户业务 > 代金券管理”。
  2. 选择“代金券额度”页签。
  3. 选择一条代金券记录,单击“操作”列的“发放”,进入“发放代金券”页面。

  4. 设置代金券参数,如:代金券面值、最小可用订单额。

    单击“显示更多详情”,可以查看代金券额度的使用限制和客户限制。

  5. (可选)配置代金券适用的云服务类型、云服务产品。

    伙伴可以单击“显示高级设置”,配置代金券适用的云服务类型、云服务产品。

  6. 选择代金券发放的客户。

    单击“添加”,添加代金券发放的客户。可一次性选择多个发放客户(不超过10个)。

  7. (可选)填写“备注信息”。

    备注信息仅发券的伙伴可查看,收券方不可查看。伙伴可以在“客户业务 > 代金券管理”页面,单击“操作记录”,查看代金券的备注信息。

  8. 单击“提交”。

    系统提示发放代金券成功。

二、合作伙伴可以登录合作伙伴中心为客户下发所拥有的现金券额度。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 现金券管理”。
  2. 选择“现金券额度”页签。
  3. 单击“操作”列的“发放”,进入“发放现金券”页面。
  4. 设置现金券参数,如“现金券面值”、有效期。

  5. 选择发放现金券的客户。

    单击“添加”,添加现金券发放的客户。可一次性添加多个发放客户(不超过10个)。

  6. (可选)填写“备注信息”。

    备注信息仅发券的伙伴可查看,收券方不可查看。伙伴可以在“客户业务 > 现金券管理”页面,单击“操作记录”,查看现金券的备注信息。

  7. 单击“提交”。

    系统提示发放现金券成功。

REST API

伙伴在伙伴销售平台使用额度为客户发放优惠券。

  • 该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token。
  • 调用该接口之前,需通过客户经理联系华为运营人员,为合作伙伴设置优惠券发放额度。

  1. URI

    POST /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    quota_id

    String

    最大长度:64

    优惠券额度ID。

    请从“发放优惠券”接口的响应参数中获取。

    customer_id

    String

    最大长度:64

    客户ID。

    face_value

    Double

    -

    代金券面值,精确到小数点后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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
        "quota_id": "2018011615520153",
        "customer_id": "f8231a7d11484dfaaea8b70755680c7e",
        "face_value": "100",
        "valid_time": "2018-01-17T11:54:00Z",
        "expire_time": "2018-01-20T11:54:00Z"
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    取值范围

    描述

    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"
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0151

    访问拒绝。

    CBC.0999

    其他错误。

    CBC.5024

    客户的关联类型不允许调用该接口。

    CBC.5043

    优惠券额度不足。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问