文档首页/ 合作伙伴中心/ API参考/ 管理交易/ 管理包年/包月订单/ 支付包年/包月产品订单
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

支付包年/包月产品订单

功能介绍

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

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

  • 余额支付包括现金账户和信用账户两种支付方式，如果两个账户都有余额，则优先现金账户支付。
  • 同时使用订单折扣和优惠券的互斥规则如下：
    • 如果优惠券的限制属性上存在simultaneousUseWithEmpowerDiscount字段，并且值为0，则优惠券和伙伴授予折扣不能同时使用。
    • 如果优惠券的限制属性上存在simultaneousUseWithContractDiscount字段，并且值为0，则优惠券和商务授权折扣不能同时使用。
    • 如果优惠券的限制属性上存在minConsumeDiscount字段，当折扣ID包含的所有订单项上的折扣率discount_ratio都小于minConsumeDiscount字段时，则折扣ID和优惠券不能同时使用。
    • 如果优惠券的限制属性上存在simultaneousUseWithPromotionDiscount字段，并且值为0，则优惠券和促销折扣不能同时使用。
  • 财务托管企业子调用该接口时，若企业主帐号存在订单可用的优惠券，则支付订单时会自动使用，无需在请求参数中携带优惠券ID。

接口约束

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

调试

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

URI

POST /v3/orders/customer-orders/pay

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

order_id

是

String

最大长度：64

订单编号。

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

use_coupon

是

String

[YES|NO]

本次订单支付是否使用优惠券。传递“YES”时，coupon_infos字段必选，传递“NO”时，会忽略coupon_infos字段的传值。

  • 使用优惠券：YES，
  • 不使用优惠券：NO

use_discount

是

String

[YES|NO]

本次订单支付是否使用折扣。传递“YES”时，discount_infos字段必选，传递“NO”时，会忽略discount_infos字段的传值。

  • 使用折扣：YES，
  • 不使用折扣：NO

coupon_infos

否

List<CouponSimpleInfo>

最多支持3个

具体参见表1。

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

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

当use_coupon参数取值为“YES”，本字段必填；当use_coupon参数取值为“NO”，本字段不可填写，否则报参数错误。

注意：

财务托管企业子调用该接口时，若企业主帐号存在订单可用的优惠券，则支付订单时会自动使用，无需在请求参数中携带优惠券ID。

discount_infos

否

List<DiscountSimpleInfo>

只支持1个

具体参见表2。

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

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

当use_discount参数取值为“YES”，本字段必填；当use_discount参数取值为“NO”，本字段不可填写，否则报参数错误。
表1 CouponSimpleInfo

参数

是否必选

参数类型

取值范围

描述

id

是

String

最大长度：64

优惠券ID。

type

是

Integer

[300-303]

优惠券类型。

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

参数

是否必选

参数类型

取值范围

描述

id

是

String

最大长度：64

折扣ID。

type

是

Integer

[0,2,3]

折扣类型。

  • 0：促销折扣
  • 2：商务优惠
  • 3：合作伙伴授予折扣
请求示例 
POST https://bss.myhuaweicloud.com/v3/orders/customer-orders/pay HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "use_coupon":"YES",
    "use_discount":"YES",
    "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）。

  • default项目对应ID：0
  • 未归集项目对应ID：-1或null
  • 其余项目对应ID获取方法请参见如何获取企业项目ID。

enterprise_project_name

String

企业项目名称。

auth_status

Integer

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

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

11：组织预算资金配额不足

响应示例

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.30000010

无效订单（可能是订单不存在），不能进行操作。

400

CBC.99003106

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

400

CBC.99003108

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

400

CBC.99003110

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

400

CBC.99003112

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

400

CBC.99003116

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

400

CBC.99003117

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

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

400

CBC.99003141

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

400

CBC.99003147

代金券和折扣券不能同时使用。

400

CBC.99003155

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

400

CBC.99003156

云商店券和专用代金券不能同时使用。

400

CBC.99003162

支付时间超过设定的生效时间。

400

CBC.99003198

企业组织预算不足。

400

CBC.99005003

余额不足。

400

CBC.99006093

获取不到税率信息。

400

CBC.99008040

操作频繁。

500

CBC.0999

其他错误。

400

CBC.99000088

抱歉，支付处理中，请勿重复操作。

400

CBC.99000089

抱歉，当前订单号不能操作，请使用组合交易单号操作。

400

CBC.99008056

今日创建交易已达上限。

相关文档