查询退款订单的金额详情-ShowRefundOrderDetails
功能介绍
伙伴在伙伴销售平台查询某次退订订单或者降配订单的退款金额所属资源类型和对应订单。
- 可以在调用完“退订包年/包月资源-CancelResourcesSubscription”接口生成退订订单ID后,调用该接口查询退订订单对应的金额所属资源类型和订单。例如,调用“退订包年/包月资源-CancelResourcesSubscription”接口退订资源及其已续费周期后,您可以调用本小节的接口查询到退订金额归属的原开通订单ID和原续费订单ID。
- 2018年5月份之后退订的订单才能查询到归属的原订单ID。
接口约束
该接口可以使用解决方案提供商或华为云总经销商(一级经销商)的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
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
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-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
状态码。 具体请参见状态码。 |
|
error_msg |
String |
错误描述信息。 |
|
total_count |
Integer |
查询总数。 |
|
refund_infos |
List<OrderRefundInfoV2> |
资源信息列表。 具体请参见表2。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
该记录的ID。 |
|
amount |
BigDecimal |
金额。
|
|
measure_id |
String |
金额的度量单位。
|
|
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"
}
]
}