BILLmanager 6 Startup, Advanced

HostMaster

BILLmanager is integrated with HostMaster, one of the popular domain name registrars.

The integration module supports the following features:

FunctionSupported
Import of domains from the registrar
Transfer of domain names
Change of name servers
Change of domain contact information
Domain name verification
WHOIS data protection management
Information about account balance on the registrar side 

Integration with HostMaster

Integration is configured in the process of creating a service processing module in BILLmanager.

To create a service processing module, enter IntegrationProcessing modules → click Add. The processing module adding wizard consists of the following steps:

  1. Product type: select "Domains".
  2. Processing module: select "HostMaster".
  3. Integration settings. Specify the data for integration:
    1. EPP server:
      • for real orders: sslv3://epp.hostmaster.ua:700;
      • for tests: sslv3://test-epp.hostmaster.ua:700.
    2. User — username for access to API HostMaster;
    3. Password — user password for access to API HostMaster;
    4. Contract number  — the number  of the contract between the registrar and the public domain administrator;
    5. Path to the certificate file — path to the security certificate file. The certificate is provided by HostMaster.
    6. Path to the key file — path to the security certificate key file. Key is provided by HostMaster;
    7. Check domain status via API — check the domain status on the registrar side. Disable to option to run the check via WHOIS. Enable the option to check via the registrar's API;
    8. Disable clientHold status check for domains  — the clientHold status is set by the registrar and it means that the domain has expired and has been placed into a hold state;
      • Enabled — when the clientHold status check is disabled a client won't receive the domain expiration notification. Resource records will be active for 29 days. Later a new customer can buy the domain.
      • Disabled — when the clientHold status check is enabled a client will receive the domain suspension notification. The domain will be suspended after the expiration date and will be activated after payment. The owner won't be changed.
  4. Processing module parameters. Configure internal (within BILLmanager) parameters of the service processing module.

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 registrar is accessible from the server with BILLmanager.
  • you can execute API calls from the IP address of BILLmanager from your account in the registrar system.
  • The security certificate has not expired.
How to check
  • Key corresponds to the certificate.
How to check

Logging

Log of interaction between HostMaster and the billing platform is recorded in file '/usr/local/mgr5/var/pmhostmaster.log'.

You can add string 'pmhostmaster.* 9' to file '/usr/local/mgr5/etc/debug.conf' to display more information in the log.