# 支付包年/包月产品订单-PayOrders #### 功能介绍 客户可以对待支付状态的包年/包月产品订单进行支付。 客户登录费用中心支付包年包月产品的待支付订单请单击[这里](https://support.huaweicloud.com/usermanual-billing/zh-cn_topic_0031512547.html)。 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) - 余额支付包括现金账户和信用账户两种支付方式，如果两个账户都有余额，则优先现金账户支付。 - 同时使用订单折扣和优惠券的互斥规则如下： - 如果优惠券的限制属性上存在simultaneousUseWithEmpowerDiscount字段，并且值为0，则优惠券和伙伴授予折扣不能同时使用。 - 如果优惠券的限制属性上存在simultaneousUseWithContractDiscount字段，并且值为0，则优惠券和商务授权折扣不能同时使用。 - 如果优惠券的限制属性上存在minConsumeDiscount字段，当折扣ID包含的所有订单项上的折扣率discount_ratio都小于minConsumeDiscount字段时，则折扣ID和优惠券不能同时使用。 - 如果优惠券的限制属性上存在simultaneousUseWithPromotionDiscount字段，并且值为0，则优惠券和促销折扣不能同时使用。 - 财务托管企业子调用该接口时，若企业主账号存在订单可用的优惠券，则支付订单时会自动使用，无需在请求参数中携带优惠券ID。 - 财务托管企业子调用该接口使用手动支付方式时，会生成一个代付订单，企业主在费用中心订单管理-企业子账号订单中可进行支付； - 财务托管企业子调用该接口使用自动支付方式时，会自动由企业主完成该订单的支付，若企业主账号存在余额不足等其他情况导致调用失败会生成一个代付订单，企业主在费用中心订单管理-企业子账号订单中，可再次进行支付。 #### 接口约束 该接口只允许使用客户AK/SK或者Token调用。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=PayOrders)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[策略授权参考](https://support.huaweicloud.com/api-oce/jac_000053.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 描述 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | |:---|:---|:---|:---|:---|:---| | billing:order:pay | 授予支付订单的权限 | write | - | - | - | #### URI POST /v3/orders/customer-orders/pay #### 请求消息 请求参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | order_id | 是 | String | 最大长度：64 | 订单编号。 取值为调用"[续订包年/包月资源-RenewalResources](https://support.huaweicloud.com/api-oce/api_order_00018.html)"接口时响应消息"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\ | 最多支持3个 | 具体参见[表1]。 优惠券ID列表，目前支持传递最多三个优惠券ID。 请从"[查询订单可用优惠券-ListOrderCouponsByOrderId](https://support.huaweicloud.com/api-oce/api_order_00015.html)"接口的响应参数中获取。 当use_coupon参数取值为"YES"，本字段必填；当use_coupon参数取值为"NO"，本字段不可填写，否则报参数错误。 注意： 财务托管企业子调用该接口时，若企业主账号存在订单可用的优惠券，则支付订单时会自动使用，无需在请求参数中携带优惠券ID。 | | discount_infos | 否 | List\ | 只支持1个 | 具体参见[表2]。 折扣ID列表，目前仅支持传递一个折扣ID。 请从"[查询订单可用折扣-ListOrderDiscounts](https://support.huaweicloud.com/api-oce/api_order_00025.html)"接口的响应参数中获取。 当use_discount参数取值为"YES"，本字段必填；当use_discount参数取值为"NO"，本字段不可填写，否则报参数错误。 | 表1CouponSimpleInfo | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | id | 是 | String | 最大长度：64 | 优惠券ID。 | | type | 是 | Integer | \[300-303\] | 优惠券类型。 - 300：折扣券 - 301：促销代金券 - 302：促销现金券 - 303：促销储值卡 | 表2DiscountSimpleInfo | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | 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": 2 } ], "order_id": "CS20052715001E4CR" } ``` #### 响应消息 **响应参数** **状态码：204** 默认返回：Success **状态码：400** | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | error_code | String | 最大长度：10 | 状态码。 具体请参见[状态码]。 | | error_msg | String | 最大长度：256 | 错误描述信息。 | | quota_infos | List\ | - | 配额或容量不足的列表。 具体请参见[表3]。 仅当"error_code"是"CBC.99003141"时此参数有值。 - 如果配额不足，请在华为云官网提交工单，扩大配额后，再支付该订单。 - 如果容量不足，请重新下单。 - 如果是规格发生变化，请重新下单。 | | enterprise_project_auth_result | List\ | - | 企业项目资金配额不足的列表。 具体请参见[表4]。 仅当"error_code"是"CBC.99003155"时此参数有值。 | 表3QuotaInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | region | String | 云服务区编码，例如："cn-north-1"。具体请参见[地区和终端节点](https://developer.huaweicloud.com/endpoint)对应云服务的"区域"列的值。 | | 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 | 可用分区标识。 取值请参见[地区和终端节点](https://developer.huaweicloud.com/endpoint)中对应区域的可用分区名称，例如"cn-north-1a"表示"华北-北京一的可用区1"。 | 表4EnterpriseProject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enterprise_project_id | String | 订单归属的企业项目标识（企业项目ID）。 - default项目对应ID：0 - 未归集项目对应ID：-1或null - 其余项目对应ID获取方法请参见[如何获取企业项目ID](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。 | | 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 ``` #### 状态码 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) - 状态码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.99003139 | 已过期或已冻结资源不可变更规格，请续费后执行此操作。 | | 400 | CBC.99003141 | 云服务配额或容量不足或规格发生变化。 | | 400 | CBC.99003143 | 抱歉，您所购买的产品已下架。 | | 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 | 今日创建交易已达上限。 |