订单相关接口

更新时间：2026-08-15

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" : "GEOTRUST",
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	String	否	BODY	时间单位，默认 YEAR（可选 MONTH、YEAR；免费证书 purchaseLength 必须为3、timeUnit 必须为 MONTH）
orderType	String	否	BODY	订单类型，默认 NEW，取值见附录 OrderType
autoApply	boolean	否	BODY	是否下单后自动申请，默认 false
serviceType	String	否	BODY	服务类型
pageResource	String	否	BODY	页面来源，默认空
virtualMerchant	boolean	否	BODY	是否为虚商订单，默认 false
applyCertRequest	Object	否	BODY	详细下单/申请参数（高级用法，一般无需填写）

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
bceOrderId	String	订单ID
orderId	String	订单ID（兼容字段，通常与 bceOrderId 一致）
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}

SSL续费订单并自动支付

接口描述

本接口用于对已有证书发起续费下单，并自动支付，支付逻辑同新购接口

请求结构

Plain Text

1> POST http://cas.baidubce.com/v3/openapi/order?renew
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  "sourceResourceId" : "b7a3e152-7ebd-4c39-8a1c-60b79c2f3367",
8  "certType" : "DV",
9  "productType" : "SINGLE",
10  "brand" : "GEOTRUST",
11  "domainNumber" : 1,
12  "wildcardNumber" : 0,
13  "purchaseLength" : 1,
14  "timeUnit" : "YEAR"
15}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
renew	String	是	Query参数	必带标志参数，值必须为空
sourceResourceId	String	是	BODY	待续费的证书资源ID
brand	String	是	BODY	证书品牌取值见附录 CertBrand
certType	String	是	BODY	证书类型取值见附录 CertType
productType	String	是	BODY	产品类型取值见附录 ProductType
domainNumber	int	是	BODY	标准域名数量
wildcardNumber	int	是	BODY	通配符域名数量
purchaseLength	int	是	BODY	购买时长（不同品牌/型号可选范围不同，见附录「各品牌各型号支持的购买时长」）
timeUnit	String	否	BODY	时间单位，默认 YEAR（可选 MONTH、YEAR）
autoApply	boolean	否	BODY	是否下单后自动申请，默认 false
applyCertRequest	Object	否	BODY	详细下单/申请参数（高级用法，一般无需填写）

说明：续费订单的 orderType 由服务端固定为 NEW，无需传入。

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
bceOrderId	String	订单ID
orderId	String	订单ID（兼容字段，通常与 bceOrderId 一致）
certIds	List< String>	证书ID列表

请求示例

Plain Text

1 > POST http://cas.baidubce.com/v3/openapi/order?renew
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: cas.baidubce.com
5 > x-bce-console-rpc-id: 63c91ede-f2c6-4aa3-b6e7-23a599a6a5f7
6 > x-bce-date: 2020-04-27T09:29:38Z
7{
8  "sourceResourceId" : "b7a3e152-7ebd-4c39-8a1c-60b79c2f3367",
9  "certType" : "DV",
10  "productType" : "SINGLE",
11  "brand" : "GEOTRUST",
12  "domainNumber" : 1,
13  "wildcardNumber" : 0,
14  "purchaseLength" : 1,
15  "timeUnit" : "YEAR"
16}

响应示例

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}

附录

CertBrand（证书品牌）

取值	描述
SECURESITE	DigiCert SecureSite
GEOTRUST	GeoTrust
GLOBALSIGN	GlobalSign
CFCA	CFCA
TRUSTASIA	TrustAsia
DIGICERT	DigiCert Basic
SSLTRUS	锐安信
UNITRUST	UniTrust

CertType（证书类型）

取值	描述
DV	域名型
OV	企业型
EV	增强型
OVPRO	企业型专业版（OV PRO）
EVPRO	增强型专业版（EV PRO）

ProductType（产品类型）

取值	描述
SINGLE	单域名
MULTI	多域名
WILDCARD	通配符域名
SINGLE_PRO	单域名专业版
MULTI_PRO	多域名专业版
WILDCARD_PRO	通配符域名专业版

OrderType（订单类型）

取值	描述
NEW	新购
RENEW	续费

TimeUnit（时长单位）

取值	描述
DAY	天
MONTH	月
YEAR	年（默认）

注：DAYS / MONTHS / YEARS 为历史遗留值，已废弃，请勿使用。

各品牌各型号支持的购买时长

下单会校验 purchaseLength（换算为年后需落在下表范围内，timeUnit 默认 YEAR）。仅下列「品牌 + 证书类型 + 产品类型」组合可下单，未列出的组合不支持。

品牌	证书类型	支持产品类型	购买时长（年）
GEOTRUST	DV	SINGLE、WILDCARD	1~3
GEOTRUST	OV	SINGLE、MULTI、WILDCARD	1~3
GEOTRUST	EV	SINGLE、MULTI	1~3
TRUSTASIA	DV	SINGLE、MULTI、WILDCARD	1
TRUSTASIA	OV	SINGLE、MULTI、WILDCARD	1
TRUSTASIA	EV	SINGLE、MULTI	1
SECURESITE	OV	SINGLE、MULTI、WILDCARD	1~3
SECURESITE	OVPRO	SINGLE_PRO、MULTI_PRO、WILDCARD_PRO	1~3
SECURESITE	EV	SINGLE	1~3
SECURESITE	EVPRO	SINGLE_PRO	1~3
GLOBALSIGN	DV	SINGLE、WILDCARD	1~3
GLOBALSIGN	OV	SINGLE、MULTI、WILDCARD	1~3
GLOBALSIGN	EV	SINGLE、MULTI	1~2
CFCA	OV	SINGLE、MULTI、WILDCARD	1~3
CFCA	EV	SINGLE、MULTI	1~3
DIGICERT	OV	SINGLE、MULTI、WILDCARD	1~3
DIGICERT	EV	SINGLE、MULTI	1~3
SSLTRUS	DV	SINGLE、WILDCARD	1~5
SSLTRUS	OV	SINGLE、MULTI、WILDCARD	1~5
SSLTRUS	EV	SINGLE、MULTI	1~5
UNITRUST	DV	SINGLE、WILDCARD	1~3
UNITRUST	OV	SINGLE、MULTI、WILDCARD	1~3

评价此篇文章

有帮助没帮助

价格相关接口

证书相关接口

百度智能云

SSL证书服务 CAS

SSL证书服务 CAS

订单相关接口

SSL新购订单并自动支付

SSL续费订单并自动支付

附录

CertBrand（证书品牌）

CertType（证书类型）

ProductType（产品类型）

OrderType（订单类型）

TimeUnit（时长单位）

各品牌各型号支持的购买时长