文档首页/ 合作伙伴中心/ API参考/ 管理交易/ 管理包年/包月订单/ 查询退款订单的金额详情-ShowRefundOrderDetails
更新时间:2025-11-20 GMT+08:00
分享

查询退款订单的金额详情-ShowRefundOrderDetails

功能介绍

伙伴在伙伴销售平台查询某次退订订单或者降配订单的退款金额所属资源类型和对应订单。

接口约束

该接口可以使用解决方案提供商或华为云总经销商(一级经销商)的AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

操作员账号调用当前API需经过授权,您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息,请参见为组织人员分配权限

接口对应的权限项如下:

权限项

权限项名称

BPC_ITEM_SUBCUSTSERV_060100|BPC_ITEM_SUBCUSTSERV_060200

  • 销售-客户-客户订单-客户订单-查看列表
  • 销售-客户-客户订单-二级经销商的客户-查看列表

URI

GET /v2/orders/customer-orders/refund-orders

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

order_id

String

最大长度:64

退订订单或者降配订单的ID。

customer_id

String

最大长度:64

客户账号ID。您可以调用查询客户列表-ListSubCustomers接口获取customer_id。

伙伴查询子客户退款订单的金额详情必须携带该字段。

indirect_partner_id

String

最大长度:64

云经销商ID。获取方法请参见查询云经销商列表。如果华为云总经销商(一级经销商)需要查询云经销商的子客户退款订单的金额详情必须携带该字段。除此之外,此参数不做处理。

请求消息

请求参数

无。

请求示例

GET https://bss.myhuaweicloud.com/v2/orders/customer-orders/refund-orders?order_id=CS1904190917GIBHC&customer_id=c9e731c4663646988ef4cdb3122837b6&indirect_partner_id=646988ef4cdb3122834feswrygfd HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数

参数类型

描述

error_code

String

状态码。

具体请参见状态码

error_msg

String

错误描述信息。

total_count

Integer

查询总数。

refund_infos

List<OrderRefundInfoV2>

资源信息列表。

具体请参见表2

表2 OrderRefundInfoV2

参数

参数类型

描述

id

String

该记录的ID。

amount

BigDecimal

金额。

  • 金额为负数,表示退订金额。
  • 金额为正数,表示收取的退订手续费。

measure_id

String

金额的度量单位。

  • 1:元

customer_id

String

客户账号ID。

resource_type_code

String

资源类型编码,例如ECS的VM为“hws.resource.type.vm”。

service_type_code

String

云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。

resource_type_name

String

资源类型名称。例如ECS的资源类型名称为“云主机”。

service_type_name

String

云服务类型名称。例如ECS的云服务类型名称为“弹性云服务器”。

region_code

String

云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

base_order_id

String

退订金额、已消费金额或收取退订手续费对应的原订单ID。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "total_count": 1,
    "refund_infos": [
        {
            "id": "ccefa7ff-****-****-99f5-bb25a2551217",
            "amount": -3,
            "measure_id": "1",
            "customer_id": "075a5d********ffb75c20a82d228130",
            "resource_type_code": "hws.resource.type.volume",
            "service_type_code": "hws.service.type.ebs",
            "resource_type_name": "云硬盘",
            "service_type_name": "云硬盘",
            "region_code": "cn-north-1",
            "base_order_id": "CS2006******1F8CI"
        }
    ]
}

状态码

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

HTTP状态码

错误码

描述

400

CBC.99005026

该订单不是降配或者退订订单。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

400

CBC.99000035

非合作伙伴子客户。

400

CBC.99000037

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

相关文档