文档首页 > > API参考> 管理交易> 管理客户账户> 回收客户账户余额

回收客户账户余额

分享
更新时间: 2020/03/05 GMT+08:00

功能介绍

当客户不再使用华为云产品时,合作伙伴可以回收客户账户余额。

Web UI

伙伴可以登录伙伴中心回收垫付类客户账户余额。

  1. 在伙伴中心左侧导航栏中选择“客户业务 > 我的客户”。
  2. 在客户列表中,选择一条客户记录,单击“操作”列的“回收”。
  3. 选择“回收账户”,设置“回收金额”后,单击“确定”。

  4. 在弹出的对话框中单击“获取验证码”,获取并输入短信验证码。

    如果未开启手机短信验证,则直接执行5

  5. 单击“确定”。

    系统提示回收成功信息。

REST API

伙伴在伙伴销售平台回收垫付类客户账户余额。

该接口只允许使用合作伙伴AK/SK或者Token调用。

  1. URI

    POST /v1.0/{partner_id}/partner/account-mgr/retrive-amount

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

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

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

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customer_id

    String

    最大长度:64

    合作伙伴关联的客户的客户ID。

    balances

    List<BeRetrieveBalance>

    -

    要回收信用额度的账本。

    具体请参见表1

    表1 BeRetrieveBalance

    参数

    是否必选

    参数类型

    取值范围

    描述

    accountType

    String

    [1|5]

    账户类型

    • 1:余额;
    • 5:奖励。

    amount

    number

    不能为负数,精确到小数点后两位。

    回收金额。

    注意该值不能大于“查询伙伴账户余额”接口响应中,对应账本的amount-designated_amount的差。

    currency

    String

    最大长度:8

    币种。该字段目前保留。

    当前固定为CNY。填写其他值将被忽略,即目前仅支持CNY。

    measureId

    Integer

    [1]

    度量单位。

    1:元

    请求示例

    POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/retrive-amount HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
        "customer_id":"64*****d5a",
        "balances":
        [
            {
                "accountType":"1",
                "amount":1.19,
                "currency":"CNY",
                "measureId":1
            }
        ]
    }

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见4

    error_msg

    String

    错误描述信息。

    trans_id

    String

    事务流水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",
      "trans_id":"XXXXXXXXXXXXXXXXXXXX"
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0999

    其他错误。

    CBC.0105

    非法的Token。

    CBC.0117

    请求非法。

    CBC.5001

    非合作伙伴。

    CBC.5002

    合作伙伴的客户不存在。

    CBC.5003

    余额不足。

    CBC.5004

    无对该客户的操作权限。

    CBC.5021

    推荐模式下不能给客户调账和回收。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区