From 58c82e92e1f25b10bb521cecff284ab481bf433b Mon Sep 17 00:00:00 2001 From: Victor Aleksejevs <42028380+ggs-victor@users.noreply.github.com> Date: Thu, 9 Aug 2018 22:35:10 +0300 Subject: [PATCH] Created addSSLOrder (markdown) --- addSSLOrder.md | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 addSSLOrder.md diff --git a/addSSLOrder.md b/addSSLOrder.md new file mode 100644 index 0000000..cff957f --- /dev/null +++ b/addSSLOrder.md @@ -0,0 +1,79 @@ +## “addSSLOrder” + +URL: /orders/add_ssl_order/
+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) \ No newline at end of file