6 Updating SSL Order

This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider SSL API methods. If you want to go the beginning of this guide, please navigate to the article "1 How to choose a product".

To get more information about our API in general, please use our documentation portal as your reference.

Using the previous method "5 Retrieving SSL Orders" we successfully retrieved our orders and details.
But what if you want to update the original parameter(s) of an order created but was not yet approved?
There are different cases to use this method:
 SSL Order status   What can be updated
  • All fields that are not connected with the product details, e.g. csr, organization_handle, etc.
  • send start_provision = true if you want to send certificate request to the CA 
 REQ   domain_validation_methods can be updated, e.g. change method from http to dns
 PAI, REQ, ACT   autorenew can be switched on/off

However, for the SSL order in status REQ approver email address value can be modified with the update approver email address method.

Entering Geo Fence iconUse endpoint path below. Base URL is determined by both the target environment and API version.
POST {base_url}/ssl/orders/{id}








 Mandatory field.
Openprovider order ID.


 string   Email address.  A valid email address from a pre-approved list. (e.g. admin@example.com).


 string  on or off  Indicates if the certificate should be automatically renewed (check renew process description for the details).
 csr  string  CSR value.  Certificate signing request including information regarding the further certificate. 
1. domain_validation_methods  array    Allows to select a specific method for Domain Validation. Hostnames in the array must be equal to hostnames specified in the request (commonName and SANs from the CSR and hostnames).
 1.1 host_name  string    Hostname specified in the request (commonName and SANs from the CSR and hostnames).
 1.2 method  string  Mandatory parameter. The validation method (e.g. 'https')
 host_names  array An array of strings.  Array of hostnames. This parameter is optional, and only allowed in combination with a multi domain SSL certificate. If passed, the hostnames in this parameter will override any hostnames in the CSR, except for the common name.


 string  Openprovider contact handle  Internal organization handle stored in resellers profile
(e.g. format: XY012345-CC).


string sha1 (deprecated) or sha2 (default) Deprecated functional, please ignore.
Default is: "sha2".


 string   linux or windows.  Certificate software platform.
Used if you changed your system configuration from Linux to Windows Server and vice versa.


 boolean   true or false (default)  If false then order won't be sent to CA, it will be in status PAI. To request it use true value.


string   Format: "XY012345-CC"  Openprovider technical handle.


curl -X PUT \
https://api.cte.openprovider.eu/v1beta/ssl/orders/31027 \
-H 'Authorization: Bearer deb4bf804928981b018caf45c3c4142b' \
-H 'Content-Type: application/json' \
-d '{
"approver_email": "admin@ssl-123-domain.com",
"autorenew": "on",
4eJiaV7IwubPS78=\n-----END CERTIFICATE REQUEST-----",
"domain_validation_methods": [
"host_name": "ssl-123-domain.com",
"method": "http"
"host_names": [
"organization_handle": "IA900531-NL",
"signature_hash_algorithm": "sha2",
"software_id": "windows",
"start_provision": true,
"technical_handle": "IA900531-NL"


"code": 0,
"data": {
"id": 1
"desc": ""






API code returned.

API Result with code returned.
0 = Sucess with no errors.

1. data

Update Order Response Data Response data returned while updating the order.

1.1 id

Digital value usually consists of 6 digits. Openprovider order ID.


Description text (if presented). Description (if presented). 


Boolean parameter: True or False. The Maintenance: True or False.

2. warnings

An array of warning messages Warning data returned while updating the order.

2.1 code

Numeric code if warning(s) detected. Code value (digits).  

2.2 data

Warning data values. Data value returned. 

2.3 desc

Description of warnings. The description value returned.  


Now we have updated our order and sent request to te CA (now order status is REQ).
In the next method, we will try "7 Update approver email" cause that help you if you no longer have an access to initial email used when submitted an order in a case if you used email domain validation method.

Was this article helpful?
0 out of 0 found this helpful
Additional questions? Submit a request