# Request SSL certificate order

This function submits a request for a certificate order to the cPanel Market provider.

Endpoint: GET /Market/request_ssl_certificates
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `access_token` (string, required)
    The access token for the session to the cPanel Market provider.
    Example: "725431a1-d5bc-11e5-a28b-8b0e09a93f05"

  - `certificate` (object, required)
    A JSON-encoded string that contains the details of the certificate.



To request multiple certificates, duplicate or increment the parameter name.
For example, to request three certificates, use the  parameter multiple times or use the ,
, and  parameters.
    Example: {"price":6,"product_id":"143","subject_names":[{"dNSName":"example.com"},{"dNSName":"example.org"}],"validity_period":["1, \"year\""],"vhost_names":["example.com"]}

  - `provider` (string, required)
    The cPanel Market provider's name.
    Example: "cPStore"

  - `identity_verification` (object)
    An object containing the required information for an EV or OV certificate. This information depends on the provider of the certificate.



The function returns this object for OV or EV certificate requests.
    Example: {"countryName":"US","duns_number":"12-345-6789","localityName":"City Name","organizationName":"Company, Inc.","organizationalUnitName":"Team Company,","postalCode":55555,"rep_email_address":"username@example.com","rep_forename":"First Name","rep_surname":"Last Name","rep_telephone":"123-456-7891","stateOrProvinceName":"ST","streetAddress":"555 Street Name"}

  - `url_after_checkout` (string)
    The URL to send the browser after the user checks out.



This URL does  contain a query string.
    Example: "http://checkout.example.com"

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "request_ssl_certificates"

  - `module` (string)
    The name of the module called.
    Example: "Market"

  - `result` (object)

  - `result.data` (object)

  - `result.data.certificates` (object)
    Information about each certificate in the order.

  - `result.data.certificates.key_id` (string)
    The private key's ID.
    Example: "ac90f_639fd_6c236062f0d7a4579a30e01612c4cee0"

  - `result.data.certificates.order_item_id` (integer)
    The ID of the ordered item.
    Example: 12345

  - `result.data.checkout_url` (string)
    The URL that the cPanel Market provider uses to process payment.
    Example: "http://store.example.com/showmethemoney.cgi"

  - `result.data.order_id` (integer)
    The order ID that the cPanel Market provider assigned.
    Example: 123456

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.status` (integer)
    *  - Success
*  - Failed: Check the errors field for more details.
    Enum: 0, 1

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings
describe non-critical failures or other problematic conditions
noted while running a API.