Skip to content

addSSLOrder

Victor Aleksejevs edited this page Aug 10, 2018 · 16 revisions

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

❗You can disable any notifications from Account Settings

Request parameters:

  • product_id - Required. product ID, can be taken from 🔗getAllProducts method
  • period - Required. Use months, example: 12/24
  • csr - Required. Can be generated using 🔗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 🔗getDomainEmail 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 🔗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_status - order status
  • success - success code (true)
  • order_amount - order amount
  • currency - order currency
  • tax - order tax if applicable
  • tax_rate - order tax rate if applicable
{
  "approver_method": {
    "http": {
      "link": "http:\/\/demo.gogetssl.com\/.well-known\/pki-validation\/37D0C93EE263FF9EEEA799215A9C3225.txt",
      "filename": "37D0C93EE263FF9EEEA799215A9C3225.txt",
      "content": "D30C576BF9EB30A75211CB799848EE5CABFCE3D8EE13212A57C9B7E42EF9BAA2\r\nCOMODOCA.COM\r\nt0827792001533920169"
     }
  },
  "order_id": 783956,
  "invoice_id": 574941,
  "order_status": "active",
  "success": true,
  "order_amount": 0,
  "currency": "EUR",
  "tax": "0.00",
  "tax_rate": "21%"
}
Clone this wiki locally