更新时间:2024-07-05 GMT+08:00
支付包年/包月产品订单(旧)

支付包年/包月产品订单(旧)

功能介绍

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

该接口即将下线,“支付包年/包月产品订单”接口请参考支付包年/包月产品订单(旧)

Web UI

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

  1. 进入“我的订单”页面。
  2. 选中“待支付”页签。
  3. 根据实际情况选择支付类型。

    • 单个支付:单击待支付订单列表对应的“支付”。

    • 合并支付:选中待支付订单前的复选框,单击“合并支付”。

  4. 选择优惠和支付方式,单击“确认付款”。

    开启敏感操作保护的客户,支付订单时需进行二次认证确认身份。

    • 优惠包含折扣优惠和优惠券。
      • 折扣优惠,包含商务授权折扣、合作伙伴授权折扣、合作伙伴调价优惠、线下合同折扣和折扣券优惠。折扣优惠不可同时使用。
        • 客户下单时选择使用促销折扣折扣券,如果促销折扣/折扣券的失效时间比订单正常取消(当前为七天)的时间少,则支付截止时间调整为促销折扣/折扣券的失效时间。

          示例:

          客户在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调用。
  • 支持选择优惠券支付,暂不支持选择其他折扣支付。
  • 该接口不支持财务托管企业子和资源账号调用。

  1. URI

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

    参数说明请参见下表。

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    domain_id

    64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
        "orderId": "CS1712271317IT8C4",
        "payAccountType": 2
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    取值范围

    描述

    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"
    }

  1. 状态码
    • 状态码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

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