更新时间:2023-12-13 GMT+08:00
分享

向云经销商发放代金券额度

功能介绍

华为云总经销商(一级经销商)可以向云经销商(二级经销商)发放代金券额度。

一级经销商在伙伴中心向二级经销商发放代金券额度请参见这里

接口约束

该接口只允许使用华为云总经销商的AK/SK或者Token调用。

调试

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

URI

POST /v2/partners/coupon-quotas/indirect-partner-adjust

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

indirect_partner_ids

List<String>

最大个数:100

云经销商ID列表。

quota_amount

BigDecimal

-

华为云总经销商向云经销商发放的代金券额度值。

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

quota_id

String

最大长度:64

华为云总经销商发放的代金券额度的ID。获取方法请参见查询优惠券额度

请求示例

POST https://bss.myhuaweicloud.com/v2/partners/coupon-quotas/indirect-partner-adjust HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "quota_id": "2018011615520150",
  "indirect_partner_ids": ["62a*****d30"],
  "quota_amount": "1.11"
}

响应消息

响应参数

参数

参数类型

描述

error_code

String

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

错误描述信息。只有失败才返回该字段。

error_details

List<ErrorDetail>

发放失败的云经销商额度信息,具体参见表1,只有HTTP STATUS 200的时候才有这个结构体。

simple_quota_infos

List<SimpleQuotaInfo>

发放成功的云经销商额度信息,具体参见表2,只有HTTP STATUS 200的时候才有这个结构体。

表1 ErrorDetail

参数

参数类型

描述

id

String

云经销商ID。

error_code

String

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

错误描述信息。只有失败才返回该字段。

表2 SimpleQuotaInfo

参数

参数类型

取值范围

描述

id

String

最大长度:128

云经销商ID。

quota_id

String

最大长度:20

分配给云经销商的代金券额度ID。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
  "error_details": [
    {
      "id": "l5241b7a12695obeca8b60633560e6c",
      "error_code": "",
      "error_msg": ""
    }
  ],
  "simple_quota_infos": [
    {
      "id": "f8231a7d11484dfaaea8b70755680c7e",
      "quota_id": "2018011615520150"
    }
  ]
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

200

CBC.50000045

不能对同一个代金券额度进行频繁操作。上一次的代金券额度划拨正在进行中,不允许并行划拨,待结束后再进行下一次操作。

400

CBC.50010105

无法给退出中的云经销商发放代金券额度

400

CBC.99000012

额度不存在或者额度状态不正确。

400

CBC.99000013

优惠券额度不足。

400

CBC.99000017

额度未生效或者已过期。

400

CBC.99000037

您没有操作该云经销商的权限。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品