Difference between revisions of "ResellerClub SSL"
From WHMCS Documentation
(→Setting up an SSL Product) |
(→Testing) |
||
| (10 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
| − | ResellerClub offers thawte's Digital Certificates | + | ResellerClub offers thawte's Digital Certificates as part of the Verisign group, one of the most trusted brands in the world. |
| − | With WHMCS, SSL ordering and provisioning is | + | With WHMCS, SSL ordering and provisioning is fully automated. SSL products that you set up are ordered in the same way as everything else via the shopping cart. No SSL-specific configuration is performed actually during the order process, to keep the ordering process simple and ensure conversions aren't lost due to barriers with the SSL setup process. |
So instead, once an order has been placed and paid for, the customer is then sent an email containing a link which takes them to configure the certificate directly on your website. This is a very simple 2 step process that they are guided through, where the client never leaves your site, and once all details have been provided, the configuration data is sent to the Certificate Authority in the background via the module and API, and a short while later, the completed certificate gets emailed directly to the client. From start to finish, no actions are required from your side so it really is a very simple addition to your product portfolio. | So instead, once an order has been placed and paid for, the customer is then sent an email containing a link which takes them to configure the certificate directly on your website. This is a very simple 2 step process that they are guided through, where the client never leaves your site, and once all details have been provided, the configuration data is sent to the Certificate Authority in the background via the module and API, and a short while later, the completed certificate gets emailed directly to the client. From start to finish, no actions are required from your side so it really is a very simple addition to your product portfolio. | ||
| − | == | + | ==Setting up an SSL Product== |
| − | + | To create a ResellerClub SSL product: | |
| − | To | + | #Create a product at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services'''. |
| + | #Set the product type to '''Other Product/Service''' | ||
| + | #Specify a name and description. | ||
| + | #Deselect '''Require Domain'''. | ||
| + | #Set '''Welcome Email''' to ''None''. For SSL products, the system sends the ''SSL Configuration Required'' email template automatically with a link to configure the certificate as soon as it processes and activates the order. | ||
| + | #Go to the '''Module Settings''' tab and select "Resellerclubssl". If you do not see this option, check whether you performed the installation steps correctly. The page will reload and display the ResellerClub SSL-related configuration options ('''Reseller ID''', '''Password''', '''Certificate Type''', and '''Test Mode'''). | ||
| + | #To find your reseller ID: | ||
| + | #* If you already have a ResellerClub account, go to '''Settings > Personal Information > Primary Profile''' within your ResellerClub account. | ||
| + | #* If you already use the ResellerClub Domains module in WHMCS, you can also go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Registrars]]''' or, prior to WHMCS 8.0, '''Setup > Domain Registrars''' and check the '''ResellerClub''' configuration. | ||
| + | #* If you don't yet have a ResellerClub account, [http://www.whmcs.com/partners/resellerclub create one]. | ||
| + | #If this is your first time using the ResellerClub API, you need to register your server's IP address with ResellerClub. To do this, log in to the ResellerClub control panel, go to '''Settings > API''', and enter the IP address for your WHMCS installation. It can take up to 30 minutes for the ResellerClub system to allow the IP address after you enter it. | ||
| − | + | ResellerClub will automatically create a custom '''Domain Name''' field in which the customer must enter the SSL certificate's domain name during the order process. You can customise this field in the '''Custom Fields''' tab, but you must use the format "Domain Name|Your Custom Name Here" so that WHMCS can still recognise the field. | |
| − | == | + | ===Pricing=== |
| − | To | + | When offering SSL certificates, you can offer them as either one time products or recurring products. We recommend recurring products because they allow you to use automatic invoicing and renewals at the end of subscription periods. To configure this, select ''Recurring'' for '''Payment Type''' in the '''Pricing''' tab for the product. Set the prices for '''Annual''' and '''Biennial''' billing cycle; they are the only supported terms. |
| − | + | Alternatively, to offer certificates for only one year, set them as either ''Recurring'', defining only the '''Annual''' billing cycle, or as a ''One Time'' product if you do not want automated renewals. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | == | + | ==Testing== |
| − | + | If you want to use '''Test Mode''', you '''must''' create a separate account on ResellerClub's dedicated testing environment. | |
| − | + | * This is completely separate from the live system. | |
| + | * You cannot use your live account details for testing. | ||
| − | + | For more information, see [http://manage.resellerclub.com/kb/servlet/KBServlet/faq415.html ResellerClub's Knowledgebase]. | |
| − | + | <div class="docs-alert-info"> | |
| + | The module's '''Create''' does not generate a username and password. The username and password will be blank in the client's '''[[Clients:Products/Services Tab|Products/Services]]''' tab. | ||
| + | </div> | ||
Latest revision as of 15:23, 3 May 2022
ResellerClub offers thawte's Digital Certificates as part of the Verisign group, one of the most trusted brands in the world.
With WHMCS, SSL ordering and provisioning is fully automated. SSL products that you set up are ordered in the same way as everything else via the shopping cart. No SSL-specific configuration is performed actually during the order process, to keep the ordering process simple and ensure conversions aren't lost due to barriers with the SSL setup process.
So instead, once an order has been placed and paid for, the customer is then sent an email containing a link which takes them to configure the certificate directly on your website. This is a very simple 2 step process that they are guided through, where the client never leaves your site, and once all details have been provided, the configuration data is sent to the Certificate Authority in the background via the module and API, and a short while later, the completed certificate gets emailed directly to the client. From start to finish, no actions are required from your side so it really is a very simple addition to your product portfolio.
Setting up an SSL Product
To create a ResellerClub SSL product:
- Create a product at Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services.
- Set the product type to Other Product/Service
- Specify a name and description.
- Deselect Require Domain.
- Set Welcome Email to None. For SSL products, the system sends the SSL Configuration Required email template automatically with a link to configure the certificate as soon as it processes and activates the order.
- Go to the Module Settings tab and select "Resellerclubssl". If you do not see this option, check whether you performed the installation steps correctly. The page will reload and display the ResellerClub SSL-related configuration options (Reseller ID, Password, Certificate Type, and Test Mode).
- To find your reseller ID:
- If you already have a ResellerClub account, go to Settings > Personal Information > Primary Profile within your ResellerClub account.
- If you already use the ResellerClub Domains module in WHMCS, you can also go to Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Domain Registrars and check the ResellerClub configuration.
- If you don't yet have a ResellerClub account, create one.
- If this is your first time using the ResellerClub API, you need to register your server's IP address with ResellerClub. To do this, log in to the ResellerClub control panel, go to Settings > API, and enter the IP address for your WHMCS installation. It can take up to 30 minutes for the ResellerClub system to allow the IP address after you enter it.
ResellerClub will automatically create a custom Domain Name field in which the customer must enter the SSL certificate's domain name during the order process. You can customise this field in the Custom Fields tab, but you must use the format "Domain Name|Your Custom Name Here" so that WHMCS can still recognise the field.
Pricing
When offering SSL certificates, you can offer them as either one time products or recurring products. We recommend recurring products because they allow you to use automatic invoicing and renewals at the end of subscription periods. To configure this, select Recurring for Payment Type in the Pricing tab for the product. Set the prices for Annual and Biennial billing cycle; they are the only supported terms.
Alternatively, to offer certificates for only one year, set them as either Recurring, defining only the Annual billing cycle, or as a One Time product if you do not want automated renewals.
Testing
If you want to use Test Mode, you must create a separate account on ResellerClub's dedicated testing environment.
- This is completely separate from the live system.
- You cannot use your live account details for testing.
For more information, see ResellerClub's Knowledgebase.
The module's Create does not generate a username and password. The username and password will be blank in the client's Products/Services tab.