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 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 "OnlineNIC".
  3. Integration settings. Specify the data for integration:
    1. User ID — login ID for logging in to OnlineNIC;
    2. Password — password for the account;
    3. API Key — the key to access the OnlineNIC API;
    4. Use test environment — enable this option if you want to integrate with the OnlineNIC test user. Read more in the documentation of API OnlineNIC;
    5. 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.
  4. Processing module parameters. Configure internal (within BILLmanager) parameters of the service processing module:
    1. Name — specify the name of the processing module to be displayed in the BILLmanager interface.
    2. Department — select the department to which tasks from the processing module will be assigned.
    3. Sort — specify the processing module’s priority. If more than one processing module is connected to a tariff plan, the processing module with the lowest priority is selected first when creating the service.
    4. Processing module minimal balance — specify the minimum amount on the personal account in the system to purchase services. For more information, see Processing Module Balance.

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 platform 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.