Enom SSL Certificates

From WHMCS Documentation

Revision as of 18:33, 2 March 2011 by John (talk | contribs)

Supported Certificate Types

This module allows you to automate SSL Certificate sales with the Enom platform. This allows you to offer the following types of certificate:

  • GeoTrust QuickSSL
  • GeoTrust QuickSSL Premium
  • GeoTrust TrueBizID
  • GeoTrust TrueBizID Wildcard
  • GeoTrust TrueBizID EV
  • RapidSSL
  • SBS Secure
  • SBS Secure Plus
  • SBS Instant
  • SBS EV
  • SBS SGC EV
  • VeriSign Secure Site
  • VeriSign Secure Site Pro
  • VeriSign Secure Site EV
  • VeriSign Secure Site Pro EV

Setting up the Product

We have prepared a video tutorial for this section @ http://whmcs.com/tutorials.php?i=12

To setup an SSL certificate product, follow the steps below.

  1. Create a product as normal - name, description, no domain options, etc...
  2. Set the billing cycle to One Time and price as the base price for this certificate
  3. Ensure the welcome email is set to "None" in the dropdown menu as the module sends it's own email
  4. On the module settings tab, choose "Enomssl"
  5. Now enter your enom login details and choose the certificate type and length being offered with this product in the fields displayed
  6. Additionally, you can let the client choose these options on the order form and alter the price accordingly using configurable options. The option names supported to override the default settings are "Certificate Type" and/or "Years" - you can use both, just the years option or even neither.

Multiple Years

As mentioned above you can allow clients to choose how long the certificate is registered for. To do this you set the product up as normal with a one time cycle and base price of zero.

Setup a Configurable Option Group in the normal way and add an option named "Years" with a dropdown of the year options and prices in the monthly field.

That then shows on the product configuration screen for the user to choose from when ordering and the price charged is the value of the option selected.

For example your configurable option might look like this:

Enom ssl config.png

The Order Process

The product will appear in the order process as a regular product which can be added to the cart. No configuration is performed before purchase. Once purchased, paid for, and activated, the user is sent an email containing a link which takes them to configure the certificate in the client area. Once all details have been provided, the configuration data is sent to the Certificate Authority for validation. No manual intervention is required from you.

Renewal

Due to limitations in Enom's API, SSL certificates cannot be renewed. Therefore your clients will need to place a new order when the certificate period ends and it's due for renewal. This is why we recommend setting up as a one time product in WHMCS.

Errors

Invalid Client IP

In order to use the Enomssl API, you must first contact them and let them know the server IP address where you will be connecting from (the server IP address where you have WHMCS installed). This is part of Enom's security measures to prevent unauthorised users being able to submit registration requests to your account.

Bad User name or Password

Ensure the username and password on the Module Settings tab matches with your eNom login details. If the test mode checkbox is ticked ensure you have registered on the test server.