Resellers and studios

ZRAZU modules for WHMCS

How a reseller installs the "ZRAZU Domains" and "ZRAZU SSL" modules in WHMCS: download the archive, test in the sandbox and issue a key for live mode.

We have two ready-made modules for WHMCS. "ZRAZU Domains" sells domains over EPP (a registrar module). "ZRAZU SSL" sells certificates over the API (a server module). You can install them together or one at a time.

The modules are available to resellers after the contract: how to become a reseller. Everything below is done in the “Reseller” section of the cabinet, visible to the owner, administrators and technicians.

What you will need

  • An active reseller contract and an EPP sandbox login: EPP connection.
  • Access to the WHMCS server and its outgoing IP address (it must be added to the login).
  • For SSL: SSL in your contract. If it is not enabled yet, write to your manager.

Step 1. Download the archive

  1. In the "Reseller" section find the "WHMCS modules" block.
  2. Choose the archive for your version: there is a package for WHMCS 8 and newer (PHP 8.1+) and a package for WHMCS 7.4–8.x on PHP 7.0–8.3.
  3. Click "Download" and compare the checksum with the one shown next to it.

The archive is closed: do not publish it or pass it to third parties. It contains both modules, their READMEs, the changelog and the EPP manual. Every download is recorded in the organization log.

Step 2. The "ZRAZU Domains" module

  1. Unpack the archive and copy the contents of the zrazu-domains/ folder into the WHMCS root.
  2. In WHMCS open System → Settings → Domain Registrars and activate "ZRAZU Domains".
  3. Enter the EPP address, login and password, and turn on test mode. Take the address and login from the "EPP connection" section.
  4. Test registration, renewal, transfer and deletion. The sandbox answers these commands with code 1001, and the outcome arrives in poll in about 30 seconds.
  5. When the test passes, in WHMCS under the domain pricing page choose "ZRAZU Domains" for the zones you need and switch the module to the live login that your manager sets up.

Step 3. The "ZRAZU SSL" module

Test it in the sandbox first. It has the same rights and answers as live mode, but the money is test money and the certificates come from an untrusted test authority.

  1. Copy the contents of the zrazu-ssl/ folder into the WHMCS root, together with the hook includes/hooks/zrazussl.php.
  2. In the "Reseller" section find the "Test key — SSL sandbox" block. Enter your WHMCS server addresses and click "Test key". Copy the key right away: we will not show it again.
  3. In WHMCS: Servers → Add New Server, type "ZRAZU SSL". Enter the sandbox API address (shown in the "Integration guide" block) and put the key in the Password field. Click Test Connection.
  4. Create a product of type Other, module "ZRAZU SSL", payment mode "Under the contract".
  5. Run the checks from the module README, including the failure trigger names.

Step 4. The live key for SSL

  1. In the "SSL under the contract and the WHMCS module" block enter your WHMCS server addresses: one per line, public IPv4 or IPv6, a network no wider than /24 and /64.
  2. Optionally give the key a name and set a daily spending limit in hryvnia: how much the module may spend from the balance per day. Above it orders are refused with a reason. Change the limit with a new key.
  3. Click "Issue the “WHMCS module (SSL)” key".
  4. Copy the key and paste it into the module settings, then click "I have copied the key". We will not show it again. All keys are later listed under "API keys".
  5. In WHMCS add a second "ZRAZU SSL" server with the live API address and this key.

The key lives for a limited time, works only from your WHMCS server addresses, and issuing a certificate needs a second factor. The validity period is shown in the cabinet.

Other billing systems

Ready-made modules exist for WHMCS. Any other billing connects over EPP by the manual: EPP connection.

If it didn't work

  • The connection is closed with code 2501. The outgoing address of your WHMCS server is not in the EPP login's allow list. Add it under "Configure" next to the login.
  • The live address does not accept the test key. The test key works only at the sandbox address. For live mode, issue a live key.
  • You lost the key. It cannot be shown a second time. Issue a new one and replace it in the module settings.
  • An order was refused because of the limit. The key's daily spending limit is exceeded. Issue a new key with a different limit.
  • The cabinet says "The archive is not built yet — write to your manager". Write to your manager via Support.
  • Any other question about the module. Check the README in the archive, and if the answer is not there, write to Support.

This page in Markdown