合作伙伴中心

本文导读

功能介绍
Web UI
REST API

展开导读

文档首页/ 合作伙伴中心/ API参考/

支付包年/包月产品订单（旧）

更新时间：2024-07-05 GMT+08:00

查看PDF

功能介绍

客户可以对待支付查询退款订单的金额详情状态的包年/包月产品订单进行支付。

说明：

该接口即将下线，“支付包年/包月产品订单”接口请参考支付包年/包月产品订单（旧）。

Web UI

客户可以在费用中心“我的订单”页面对待支付状态的包年/包月产品订单进行支付。

进入“我的订单”页面。
选中“待支付”页签。
根据实际情况选择支付类型。
- 单个支付：单击待支付订单列表对应的“支付”。
- 合并支付：选中待支付订单前的复选框，单击“合并支付”。
选择优惠和支付方式，单击“确认付款”。

说明：

开启敏感操作保护的客户，支付订单时需进行二次认证确认身份。
- 优惠包含折扣优惠和优惠券。
  - 折扣优惠，包含商务授权折扣、合作伙伴授权折扣、合作伙伴调价优惠、线下合同折扣和折扣券优惠。折扣优惠不可同时使用。
    说明：
    客户下单时选择使用促销折扣或折扣券，如果促销折扣/折扣券的失效时间比订单正常取消（当前为七天）的时间少，则支付截止时间调整为促销折扣/折扣券的失效时间。
    示例：
    
    客户在2018/11/26 23:12:32下单购买某云服务时，选择使用有效期为2018-11-01 00:00:00~2018-11-30 23:59:59的 8折折扣券。这时，该订单的失效时间调整为2018/11/30 23:59:59。（正常订单的失效时间为7天，即2018/11/26 23:12:32下单时创建订单，订单的失效时间为2018/12/03 23:12:32。）
    
    客户下单时选择适应合同商务授权折扣或合作伙伴授予折扣，支付订单时以下单的价格为准。即客户下单时折扣在有效期，虽支付时折扣已过期，但支付时折扣价格不变，依旧享受折扣。
    示例：
    
    客户在2018/11/26 23:12:32下单购买某云服务时，选择使用有效期为2018-11-01 00:00:00~2018-11-30 23:59:59的 8折合同商务授权折扣。订单失效时间（2018/12/03 23:12:32）前，支付该订单仍可享8折的优惠。
  - 优惠券包含现金券和代金券。
    说明：
    
    对于弹性云服务器、云硬盘、虚拟私有云的新购订单和规格变更订单，请在订单确认页面勾选可使用的折扣优惠。进入支付页面，不可再修改折扣优惠，但可以使用现金券或代金券。
    
    当伙伴为子客户设置订单折扣后，子客户支付订单时，不可再修改折扣优惠。
- 系统支持余额支付、在线支付和月度账单结算三种支付方式。

REST API

客户在伙伴销售平台完成待支付状态的包年/包月产品订单的支付。

说明：

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

支持选择优惠券支付，暂不支持选择其他折扣支付。
该接口不支持财务托管企业子和资源账号调用。

URI

POST /v1.0/{domain_id}/customer/order-mgr/order/pay

参数说明请参见下表。

表1 URI参数说明
参数	是否必选	取值范围	描述
domain_id	是	64	客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
orderId	是	String	最大长度：64	订单编号。取值为调用“查询订单列表（旧）”接口时响应消息中的“orderId”字段的值或调用“续订包年/包月资源（旧）”接口时响应消息“order_ids”中的订单ID。
payAccountType	否	Integer	[1\|2]	支付账户类型。 1：华为云账户（客户直接向华为充值） 2：客户接受合作伙伴设置预算的账户若客户为合作伙伴的转售类型客户，此处应不传值或传值为2；若客户为合作伙伴的顾问销售类型客户，此处应不传值或传值为1。若不传值（不携带或携带值为null），系统会根据账户类型自行选择支付。
couponIds	否	List<String>	[0-3]	字段预留。该参数不携带或携带值为null或携带为空数组时，支付时不会使用优惠券。

参数

是否必选

参数类型

取值范围

描述

orderId

是

String

最大长度：64

订单编号。

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

payAccountType

否

Integer

[1|2]

支付账户类型。

1：华为云账户（客户直接向华为充值）
2：客户接受合作伙伴设置预算的账户

若客户为合作伙伴的转售类型客户，此处应不传值或传值为2；

若客户为合作伙伴的顾问销售类型客户，此处应不传值或传值为1。

若不传值（不携带或携带值为null），系统会根据账户类型自行选择支付。

couponIds

否

List<String>

[0-3]

字段预留。

该参数不携带或携带值为null或携带为空数组时，支付时不会使用优惠券。

请求示例

POST https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/customer/order-mgr/order/pay HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "orderId": "CS1712271317IT8C4",
    "payAccountType": 2
}

响应消息

响应参数

参数	参数类型	取值范围	描述
error_code	String	最大长度：10	状态码。具体请参见4。
error_msg	String	最大长度：256	错误描述信息。
tradeNo	String	最大长度：64	该订单对应的支付流水号。
quotaInfos	List<QuotaInfo>	-	配额或容量不足的列表。具体请参见表2。仅当“error_code”是“CBC.3141”时此参数有值。如果配额不足，请通知客户在华为云官网提交工单，扩大配额后，再支付该订单。如果容量不足，请通知客户重新下单。如果是规格发生变化，请通知客户重新下单。
enterpriseProjectAuthResult	List<EnterpriseProject>	-	企业项目资金配额不足的列表。具体请参见表3。仅当“error_code”是“CBC.3155”时此参数有值。

表2 QuotaInfo
参数	参数类型	描述
regionCode	String	云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。
cloudServiceType	String	云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
resourceType	String	资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。
resourceSpecCode	String	客户购买云服务产品的资源规格。例如VM的资源规格举例为“s2.small.1.linux”。
authResult	Integer	云服务配额、容量或规格发生变化校验结果。 1：配额不足。 2：容量不足。 3：资源规格错误，仅发生在下单和支付之间资源规格发生变化的场景。 4：关联资源信息错误，仅发生在下单和支付之间资源规格发生变化的场景。 99：其他错误，仅发生在下单和支付之间资源规格发生变化的场景。
availableZoneId	String	可用分区标识。取值请参见地区和终端节点中对应区域的可用分区名称，例如“cn-north-1a”表示“华北-北京一的可用区1”。

表3 EnterpriseProject
参数	参数类型	描述
enterpriseProjectId	String	订单归属的企业项目ID。
enterpriseProjectName	String	企业项目名称。
authStatus	Integer	企业项目资金配额校验结果。 10：资金配额不足/项目不可用

响应示例:

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

{
    "error_code": "CBC.0000",
    "error_msg": "success",
    "quotaInfos": [],
    "enterpriseProjectAuthResult": [],
    "tradeNo": "f141b*****0fe6"
}

状态码

说明：

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

HTTP状态码	错误码	描述
200	CBC.0000	成功。
400	CBC.0100	参数错误。
403	CBC.0151	访问拒绝。
500	CBC.0999	其他错误。
400	CBC.3106	订单状态已发生变更，不能进行支付操作。
400	CBC.3112	优惠券或储值卡已被使用。
400	CBC.3141	云服务配额或容量不足或规格发生变化。
400	CBC.3155	企业项目资金配额不足。
400	CBC.99003156	云商店券和专用代金券不能同时使用。
400	CBC.99003198	企业组织预算不足。
400	CBC.3162	支付时间超过设定的生效时间。
400	CBC.5003	余额不足。
400	CBC.7281	您的账号已被冻结，无法续订/退订/支付。
200	CBC.5023	账户类型与合作伙伴关联类型不匹配。请根据2中请求参数“payAccountType”的描述修改“payAccountType”的取值或直接不传值。
500	CBC.30000010	无效订单（可能是订单不存在），不能进行操作。
400	CBC.99000089	抱歉，当前订单号不能操作，请使用组合交易单号操作。

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消