订单相关接口
更新时间：2025-08-21
SSL新购订单并自动支付
接口描述
本接口用于购买SSL证书，并且自动支付，自动支付可以使用 代金券，账号返点，账号余额
关于 API 支付逻辑的说明
默认会尽量使用代金券全额支付，不足部分使用默认逻辑处理。
默认逻辑即有账期默认账期支付
无账期则按照返点 > 现金的顺序支付；
代金券顺序：优先使用最快过期的、满足金额的代金券
请求结构
Plain Text
1> POST http://cas.baidubce.com/v3/openapi/order?new
2> Authorization: authorization string
3> Host: cas.baidubce.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
6{
7 "certType" : "DV",
8 "productType" : "SINGLE",
9 "orderType" : "NEW",
10 "brand" : "BAIDUTRUST",
11 "domainNumber" : 1,
12 "wildcardNumber" : 0,
13 "purchaseLength" : 2
14}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| new | String | 是 | Query参数 | 必带标志参数，值必须为空 |
| brand | String | 是 | BODY | 证书品牌 取值见附录CertBrand |
| certType | String | 是 | BODY | 证书类型 取值见附录CertType |
| productType | String | 是 | BODY | 产品类型 取值见 ProductType |
| domainNumber | int | 是 | BODY | 标准域名数量 |
| wildcardNumber | int | 是 | BODY | 通配符域名数量 |
| purchaseLength | int | 是 | BODY | 购买年限 （每个品牌每种证书不一定相同，具体参见控制台） |
| timeUnit | int | 否 | BODY | 时间单位默认为YEAR (可选MONTH YEAR，免费证书purchaseLength必须为3，timeUnit必须为MONTH) |
| orderType | String | 是 | BODY | 订单类型 取值见附录 OrderType |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bceOrderId | String | 订单ID |
| certIds | List< String> | 证书ID |
请求示例
Plain Text
1 > POST http://cas.baidubce.com/v3/openapi/order?new
2 > Authorization: bce-auth-v1/f624059c33b948319ad3b8a4a6c5b670/2020-04-27T09:29:38Z/3600/host;x-bce-console-rpc-id;x-bce-date/fe48acdd7ac62c215fe567fa0536f29c7096d5103ccd3eaa3ad5e1fbd163b7b4
3 > Content-Type: application/json
4 > Host: 10.133.101.20
5 > x-bce-console-rpc-id: 63c91ede-f2c6-4aa3-b6e7-23a599a6a5f7
6 > x-bce-date: 2020-04-27T09:29:38Z
7{
8 "certType" : "DV",
9 "productType" : "SINGLE",
10 "brand" : "GEOTRUST",
11 "domainNumber" : 1,
12 "wildcardNumber" : 0,
13 "purchaseLength" : 1,
14 "timeUnit" : "YEAR"
15}响应示例
Plain Text
1 < Content-Type: application/json;charset=UTF-8
2 < Date: Mon, 27 Apr 2020 09:30:18 GMT
3 < Server: BWS
4 < Transfer-Encoding: chunked
5 < x-bce-request-id: b1d08f72-cc3f-4d8e-b368-e35d3d2a94ce
6{
7 "bceOrderId": "989bdbc4e7da42e892dd07d4b2834a08",
8 "certIds": ["b7a3e152-7ebd-4c39-8a1c-60b79c2f3367"]
9}