更新时间:2022-05-24 GMT+08:00
分享
回收优惠券

回收优惠券

功能介绍

对于合作伙伴已经下发给客户的优惠券,如遇发错或其他特殊情况,合作伙伴有回收的权利。优惠券回收后,客户将不再拥有该优惠券。

该接口即将下线,“回收优惠券”接口请参考回收优惠券

Web UI

一、合作伙伴可以登录合作伙伴中心回收发给客户的代金券。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 代金券管理”。
  2. 选择“已发放代金券”页签。
  3. 单击“操作”列的“回收”。

    • 只有当前状态为“可使用”的代金券才能回收。
    • 回收代金券会将代金券的余额全部回收,不支持指定金额回收。
    • 支持批量回收代金券。即同时勾选多条代金券记录,单击“批量回收”。

  4. 在“回收代金券”页面,单击“确定”。

    回收成功后,系统弹窗显示实际回收代金券的金额。

    伙伴回收代金券后,仍然可以在“已发放代金券”页面,查询已回收的代金券记录。

二、合作伙伴可以登录合作伙伴中心回收发给客户的现金券。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 现金券管理”。
  2. 选择“已发放现金券”页签。
  3. 回收现金券。

    • 单个回收
      1. 单击操作列的“回收”。

      2. 在系统弹出“回收现金券”对话框中,单击“确认”。

        回收成功后,系统弹窗显示实际回收现金券的金额。

    • 批量回收
      1. 在现金券列表中,选择需要回收的所有现金券,单击“批量回收”。

      2. 在系统弹出的“批量回收现金券”对话框中,单击“确认”。

        回收成功后,系统弹窗显示每个实际回收现金券的金额。

    伙伴回收现金券后,仍然可以在“已发放现金券”页面,查询已回收的现金券记录。

REST API

伙伴在伙伴销售平台回收下发给客户的优惠券。

该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token。

  1. URI

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

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

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

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

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    coupon_id

    String

    最大长度:64

    待回收的代金券ID。

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

    请求示例

    POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/promotion-mgr/recycle-partner-coupons HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
        "coupon_id": "CP180117115414HB5I"
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:16

    状态码。

    具体请参见4

    error_msg

    String

    最大长度:1024

    错误描述信息。

    响应示例

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

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

    状态码

    描述

    CBC.0000

    成功。

    CBC.0151

    访问拒绝。

    CBC.5024

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

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品

close