更新时间:2024-11-26 GMT+08:00

查询退款订单的金额详情

功能介绍

客户在伙伴销售平台查询某次退订订单或者降配订单的退款金额来自哪些资源和对应订单。

  • 可以在调用完“退订包年/包月资源”接口生成退订订单ID后,调用该接口查询退订订单对应的金额所属资源类型和订单。例如,调用“退订包年/包月资源”接口退订资源及其已续费周期后,您可以调用本小节的接口查询到退订金额归属的原开通订单ID和原续费订单ID。
  • 2018年5月份之后退订的订单才能查询到归属的原订单ID。

接口约束

该接口可以使用伙伴置换子客户的Token调用,置换前需伙伴申请客户授权客户给伙伴创建委托

调试

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

URI

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

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

order_id

String

最大长度:64

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

请求消息

请求参数

无。

请求示例

GET https://bss-intl.myhuaweicloud.com/v2/orders/customer-orders/refund-orders?order_id=CS1904190917GIBHC 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

云服务区编码,例如:“ap-southeast-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": "ap-southeast-1",
            "base_order_id": "CS2006******1F8CI"
        }
    ]
}

状态码

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

HTTP状态码

错误码

描述

400

CBC.99005026

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

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。