BILLmanager 5 Documentation

DRS

BILLmanager is integrated with DRS, one of the popular domain name registrars, over EPP protocol.

The integration module supports the following features:

Feature Supported
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

Integration setup

Integration is set up when a new processing module is added in BILLmanager. This module can be added in IntegrationProcessing modules → button Add.

  • Step 1 — Product type. Select a product type. Please select Domains for integration with DRS.
  • Step 2 — Processing module. Select a processing module. You need to select DRS.
  • Step 3 — Integration settings. Enter information for integration with DRS.
  • Step 4 — Processing module parameters. Set up the internal parameters of the module.

Settings

Client in the processing system — you can use an existing account or create a new one. If you want to use the existing account please provide the following parameters:  

  • API Host — address for access to API: https://api.drs.ua/;
  • Login  — user ID in the DRS system;
  • Password — password in DRS system;
  • 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;
  • 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. 

Select the option Add new to go to DRS user sign up form. 

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.

Types of domain name contacts

If necessary, you can configure contact types for domain registration in a particular zone:

  1. Create a separate file:

    /usr/local/mgr5/etc/pmdrs.conf
  2. Specify the required types of domain zone contacts:

    biz.ua registrant admin tech billing
    укр registrant admin tech billing
  3. Restart BILLmanager.

    /usr/local/mgr5/sbin/mgrctl -m billmgr exit

Logging

Log of interaction between DRS and the billing system is recorded in file '/usr/local/mgr5/var/pmdrs.log'.

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