BILLmanager 5 Documentation

OnlineNIC

BILLmanager has a built-in integration module with the domain name registrar OnlineNIC.

The integration module supports the following:

FunctionSupport available
Importing domains from the registrar
Domain name transfer
Domain name editing
Changing domain contact information
Domain name verification
Managing the "WHOIS data protection" option
Getting information about the account balance on the registrar side
Note.

Before importing, make sure that the domain name is suitable for the transfer. Read more in Domain management.

Contacts are imported for each domain, even if the contact information is completely the same.

Configuring integration with OnlineNIC

Integration is configured during the creation of a service processing module in BILLmanager. To create a processing module, enter IntegrationProcessing modulesCreate button.

The processing module-adding wizard consists of four steps:

  • Step 1 — Product type. Select the product type. For integration with OnlineNIC, select Domains.
  • Step 2 — Processing module. Select OnlineNIC as the processing module.
  • Step 3 — Configuring the integration. Enter the information required for integration with OnlineNIC.
  • Step 4 — Service processing module settings. Specify internal (within BILLmanager) parameters of the service processing module.

Configuring the integration

  • User ID - login ID for logging in to OnlineNIC;
  • Password - password for the account;
  • API Key - the key to access the OnlineNIC API;
  • Use test environment - enable this option if you want to integrate with the OnlineNIC test user. Read more in the documentation of API OnlineNIC;
  • Checking the status of a domain name through the API is a way to check the availability of a domain:
    • option enabled - via the domain registrar's API;
    • option disabled - via the WHOIS service.

Configuring integration with OnlineNIC

Connection check

On the last step of adding a processing module, BILLmanager tries to connect to the registrar with the specified details.

If the connection ends with the error "Failed to connect to the processing module", make sure that:

  • the connection details are correct;
  • The URL of the domain name registrar is accessible from the server where BILLmanager is installed;
  • in the Registrar's client area, it is allowed to make API requests from BILLmanager’s IP address.

Logging

The log of interaction between the billing system and OnlineNIC is written to the /usr/local/mgr5/var/pmonlinenic.log file

For extended logging information display, add the "pmonlinenic.* 9" line to the /usr/local/mgr5/etc/debug.conf file.