DRS

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

The integration module supports the following features:

Integration setup

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

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

1. Product type: select "Domains".
2. Processing module: select "DRS".
3. Integration settings. Specify the data for integration:
   Complete the form using the details of an existing client in the handler's system:
   
   1. API Host — address for access to API: https://api.drs.ua/.
   2. Login  — user ID in the DRS system.
   3. Password — password in DRS system.
   4. 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.
   5. 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.
   Activate the Add New Client option to display a link to register with the handler's system.
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 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 platform 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.