Integration setup
To add a new integration module go to Integration → Processing modules → Add and perform the following steps:
- Step 1. Select the product type "SSL certificates".
- Step 2. Select the processing module "Namecheap".
- Step 3. Enter the information for integration with Namecheap.
- Step 4. Enter the processing module parameters.
Settings
Option Client in the processing system allows to use the existing account in the registrar system or create a new account. If you have selected the first option, please specify the following information:
- Username — username in Namecheap system;
- API user — username for access to API;
- API key — key for access to API;
- BILLmanager IP — IP-address from where requests to Namecheap will be sent;
- Sandbox — use testing access for test requests.
If you have selected Add new, the system will show the link to registration at Namecheap.
Connection test
On the last step, BILLmanager tries to connect to the registrar with the data you have specified.
If connection ends up with the error: Cannot connect to the processing module, we recommend to check that:
- connection data is correct;
- the URL address of the certification authority is accessible from the server with BILLmanager;
- you can execute API calls from the IP address of BILLmanager from your account in the certification authority.
Multi-year certificates
Since September 1, 2020, Mozilla, Safari and Google Chrome browsers do not support SSL certificates with validity period longer than 398 days. Their policies have been changed to improve security.
In this regard, certification centers offer a solution for purchasing long-term certificates — a subscription to SSL certificates. With a multi-year subscription, you pay for the certificate for several years in advance and reissue it annually.
In BILLmanager, automatic reissue of certificates by subscription has been implemented for the Namecheap processing module.
For example, your client orders and pays for an SSL certificate on October 20, 2020 for 5 years. After successful registration in the BILLmanager client area, this certificate has two fields: End date and Paid till. In the End date field, the date of 20.10.2021 will be specified as the date until which the current certificate is valid. In the Paid till field, the date of 20.10.2025 will be specified as the end date of the pair period. Each year during this period, BILLmanager will automatically reissue the certificate for the following year.
If a certificate is purchased for one year, the field Paid till remains empty.
Logging
Log of interaction between Namecheap and the billing system is recorded in file /usr/local/mgr5/var/pmnamecheap.log.
You can add string "pmnamecheap.* 9" to file /usr/local/mgr5/etc/debug.conf to display more information in the log.