更新时间:2022-05-24 GMT+08:00
分享

支付包年/包月产品订单

功能介绍

客户可以对待支付状态的包年/包月产品订单进行支付。

客户登录费用中心支付包年包月产品的待支付订单请单击这里

  • API支持月度结算和余额支付两种支付方式,月度结算优先。
  • 余额支付包括现金账户和信用账户两种支付方式,如果两个账户都有余额,则优先现金账户支付。
  • 同时使用订单折扣和优惠券的互斥规则如下:
    • 如果优惠券的限制属性上存在simultaneousUseWithEmpowerDiscount字段,并且值为0,则折扣和优惠券不能同时使用。
    • 如果优惠券的限制属性上存在minConsumeDiscount字段,当折扣ID包含的所有订单项上的折扣率discount_ratio都小于minConsumeDiscount字段时,则折扣ID和优惠券不能同时使用。

接口约束

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

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/orders/customer-orders/pay

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

order_id

String

最大长度:64

订单编号。

取值为调用“查询订单列表”接口时响应消息中的“order_id”字段的值或调用“续订包年/包月资源”接口时响应消息“order_ids”中的订单ID。

coupon_infos

List<CouponSimpleInfo>

最多支持3个

优惠券ID列表,目前支持传递最多三个优惠券ID。

请从“查询订单可用优惠券”接口的响应参数中获取。

具体参见表1

discount_infos

List<DiscountSimpleInfo>

只支持1个

折扣ID列表,目前仅支持传递一个折扣ID。

请从“查询订单可用折扣”接口的响应参数中获取。

具体参见表2

表1 CouponSimpleInfo

参数

是否必选

参数类型

取值范围

描述

id

String

最大长度:64

优惠券ID。

type

Integer

[300-303]

折扣类型。

  • 300:折扣券
  • 301:促销代金券
  • 302:促销现金券
  • 303:促销储值卡
表2 DiscountSimpleInfo

参数

是否必选

参数类型

取值范围

描述

id

String

最大长度:64

折扣ID。

type

Integer

[0-3,609]

折扣类型:

  • 0:促销折扣
  • 1:合同折扣
  • 2:商务优惠
  • 3:合作伙伴授予折扣
  • 609:订单调价折扣
    说明:

    订单支付时,如果包含609折扣(订单调价折扣),则必须使用,不能再更换折扣类型。

请求示例

POST https://bss.myhuaweicloud.com/v2/orders/customer-orders/pay HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "coupon_infos": [
        {
            "id": "CP200527025610NGSC",
            "type": 301
        }
    ],
   "discount_infos": [
        {
            "id": "PDP2011260815047721TYT48G0BA02EI",
            "type": 1
        }
    ],
    "order_id": "CS20052715001E4CR"
}

响应消息

响应参数

状态码:204

默认返回:Success

状态码:400

参数

参数类型

取值范围

描述

error_code

String

最大长度:10

状态码。

具体请参见状态码

error_msg

String

最大长度:256

错误描述信息。

quota_infos

List<QuotaInfo>

-

配额或容量不足的列表。

具体请参见表3

仅当“error_code”是“CBC.99003141”时此参数有值。

  • 如果配额不足,请通知客户在华为云官网提交工单,扩大配额后,再支付该订单。
  • 如果容量不足,请通知客户重新下单。
  • 如果是规格发生变化,请通知客户重新下单。

enterprise_project_auth_result

List<EnterpriseProject>

-

企业项目资金配额不足的列表。

具体请参见表4

仅当“error_code”是“CBC.99003155”时此参数有值。

表3 QuotaInfo

参数

参数类型

描述

region

String

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

service_type_code

String

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

resource_type_code

String

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

ResourceType是CloudServiceType中的一种资源,CloudServiceType由多种ResourceType组合提供。

resource_spec_code

String

客户购买云服务产品的资源规格。

例如VM的资源规格举例为“s2.small.1.linux”。

service_type_name

String

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

resource_type_name

String

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

auth_result

Integer

云服务配额、容量或规格发生变化校验结果。

  • 1:配额不足。
  • 2:容量不足。
  • 3:资源规格错误,仅发生在下单和支付之间资源规格发生变化的场景。
  • 4:关联资源信息错误,仅发生在下单和支付之间资源规格发生变化的场景。
  • 99:其他错误,仅发生在下单和支付之间资源规格发生变化的场景。

available_zone

String

可用分区标识。

取值请参见地区和终端节点中对应区域的可用分区名称,例如“cn-north-1a”表示“华北-北京一的可用区1”。

表4 EnterpriseProject

参数

参数类型

描述

enterprise_project_id

String

订单归属的企业项目标识(企业项目ID)。

enterprise_project_name

String

企业项目名称。

auth_status

Integer

企业项目资金配额校验结果。

10:资金配额不足/项目不可用

响应示例:

HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 

状态码

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

HTTP状态码

错误码

描述

400

CBC.99000046

预算不足。

400

CBC.30000010

无效订单(可能是订单不存在),不能进行操作。

400

CBC.99003106

订单状态已发生变更,不能进行支付操作。

400

CBC.99003108

您选择的折扣不可用于该订单。

400

CBC.99003110

订单已经过了支付截止时间,请重新提交订单。

400

CBC.99003112

优惠券或储值卡已被使用。

400

CBC.99003115

抱歉,当前操作出现异常,请稍后再试。

400

CBC.99003116

选择的优惠券限制不能和折扣同时使用。

400

CBC.99003117

选择的优惠券配置了最小折扣比例,而选择的折扣小于这个折扣比例。

例如:优惠券配置的最小折扣比例为90%,而选择的折扣在所有订单行上都小于90%,则该折扣不可使用。

400

CBC.99003141

云服务配额或容量不足或规格发生变化。

400

CBC.99003151

您选择的折扣不可与其他折扣一起使用。

400

CBC.99003155

企业项目资金配额不足/项目不可用。

400

CBC.99003156

云市场券和专用代金券不能同时使用。

400

CBC.99003162

您购买的加油包不满足支付条件。

400

CBC.99005003

余额不足。

400

CBC.99005036

该客户不支持使用接口支付。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品

close