Created addSSLOrder (markdown)

master
Victor Aleksejevs 2018-08-09 22:35:10 +03:00
parent 45a421e5cf
commit 58c82e92e1
1 changed files with 79 additions and 0 deletions

79
addSSLOrder.md Normal file

@ -0,0 +1,79 @@
## “addSSLOrder”
URL: /orders/add_ssl_order/<br/>
Request type: POST
### Overview
AddSSLOrder allows creation of New SSL Order. Includes submittion of information like: CSR code, validation method, Technical/Administrative contact details and Organization details.
Our system sends two (2) automatical emails once addSSLOrder method used:
1. New Order Notification email will be sent to Account Owner E-mail, not the end-customer
2. Generated PDF invoice
:exclamation:You can disable any notifications from Account Settings
### Request parameters:
* product_id - Required. product ID, can be taken from :link:[getAllProducts](https://github.com/gogetssl/api/wiki/getAllProducts) method
* period - Required. Use months, example: 12/24
* csr - Required. Can be generated using :link:[generateCSR](https://github.com/gogetssl/api/wiki/generateCSR)
* server_count - Required. Server Licenses, for Unlimited pass “-1”
* approver_email - Required. DCV approver email for the primary domain, can be taken from
the list provided by :link:[getDomainEmail](https://github.com/gogetssl/api/wiki/getDomainEmails) methods. This parameter must be used only if dcv_method pameter value is 'email'.
* approver_emails - A comma separated list of domain control validation e-mail addresses. One
and only one e-mail must be provided for each additional domain provided in dns_names
parameter. DCV e-mail address for the primary domain must not be included to the list. This
parameter must be used only if dcv_method prameter value is 'email'.
* webserver_type - Required. Webserver type, can be taken from :link:[getWebservers](https://github.com/gogetssl/api/wiki/getWebservers) method
* dns_names Required for SAN/UCC/Multi-Domain SSL, for the rest of products this parameter
must not be provided. A comma separated list of additional domain names. The list must not
contain the primary domain.
* admin_firstname - Required.
* admin_lastname - Required.
* admin_organization - required for OV/EV SSL certificates
* admin_addressline1 - required for OV/EV SSL certificates
* admin_phone - Required.
* admin_title - Required.
* admin_email - Required.
* admin_city - required for OV SSL certificates
* admin_country - required for OV SSL certificates
* admin_fax - required for OV SSL certificates
* admin_postalcode
* admin_region
* dcv_method Required. Value of this specifies DCV method to be used. Possible values: 'email',
'http', 'https', 'dns'.
* tech_firstname - Required .
* tech_lastname - Required .
* tech_organization - required for OV SSL certificates
* tech_addressline1
* tech_phone - Required.
* tech_title - Required.
* tech_email - Required.
* tech_city - required for OV/EV SSL certificates
* tech_country - required for OV/EV SSL certificates
* tech_fax
* tech_postalcode
* tech_region
* org_name - required for OV/EV SSL certificates
* org_division - required for OV/EV SSL certificates
* org_duns, DUNS number
* org_addressline1 - required for OV/EV SSL certificates
* org_city - required for OV/EV SSL certificates
* org_country - required for OV/EV SSL certificates
* org_fax
* org_phone - required for OV/EV SSL certificates
* org_postalcode - required for OV/EV SSL certificates
* org_region - required for OV SSL certificates
* signature_hash hashing algorythm ('SHA2')
**Note:** Quantity of items in the _approver_emails_ list must be always equal to quantity of items in
the _dns_names_ list.
### Response
If no errors in request following parameters will be returned:
* order_id - unique order ID
* invoice_id - unique invoice ID
* order_amount - order amount
* currency - order currency
* tax - order tax if applicable
* tax_rate - order tax rate if applicable
* success - success code (true)