Heart Internet

• Documentation Home
• General Information
  • System Requirements
  • Installing WHMCS
  • Upgrading
  • Release Notes
  • Further Security Steps
  • Importing Data
  • Licensing
  • Common Troubleshooting Tips
• Key Aspects
  • Clients
  • Orders
  • Products
  • Domains
  • Invoicing
  • Transactions
  • Support Tickets
  • Messages & Emails
• Setup/Configuration
  • General Settings
  • Automation Settings
  • Payment Gateways
  • Admins/Permissions
  • Products/Services
  • Support Departments
• Developer Resources
  • Client Area Templates
  • Order Form Templates
  • Language Files
  • Action Hooks
  • Widgets
  • Creating Modules
  • API

Supported Features

The following ports should be open for outbound connections from your WHMCS server: 700(live) & 1701(test)

Information

Heart Internet is a UK based reseller web hosting and domain name provider and in WHMCS we have modules for both their hosting and domain reseller API's.

The Heart modules are included in version 5 as standard. If using an older version of WHMCS you can download the Heart Internet modules @ www.whmcs.com/members/dl.php?type=d&id=52 (Updated 28th September 2011) and to install simply upload the files to the modules folder of your WHMCS installation. Then follow the guides below for setting up and configuring the modules.

Hosting Module

Supported Functionality

• Account Creation
• Suspension
• Unsuspension
• Account Termination
• Automatic Upgrades/Downgrades
• Password Resets (from Client & Admin Area)
• Automatic Login

Package Setup/Configuration

Begin by going to Setup > Products/Services > Servers and adding a new server. The name can be anything you want, the module must be set as "Heartinternet" and your Username & Password for Heart's API (which can be obtained from https://customer.heartinternet.co.uk/manage/api) needs to be entered into the appropriate fields. The other fields of the server profile are all optional.

Next it's onto the products. If you already have your packages setup then just edit those to add the Heart settings, but if not then create a new product in the normal way from Setup > Products/Services, and then on the Module Settings tab select "Heartinternet" from the dropdown. There you'll find 2 fields - Test Mode & Package ID. Enter the Package ID which should be a value you can get from inside your heart control panel and then select the automation setting you want for orders of this item (ie. auto setup on first payment, or only after accepting the pending order, etc..) then save.

Now try a test order to check everything is ok. If setup of the hosting account fails for any reason and the account remains pending, check in Utilities > Activity Log for any errors returned from the API.

Domain Registrar Module

Supported Functionality

Setup/Configuration

Configuring the domain module is very easy, simply go to Setup > Domain Registrars, select Heartinternet from the dropdown menu and then enter your API Username & Password obtained from https://customer.heartinternet.co.uk/manage/api.

Then in Setup > Domain Pricing, assign "Heartinternet" in the Automation Registration dropdown for the TLDs that you want Heart Internet to be used for and you're done.

Common Problems

Caught exception: Communication failure

Please ensure the following ports are open for outbound connections from your WHMCS server: 700(live) & 1701(test). This error suggests your firewall is blocking connections to HeartInternet and should be opened.