Difference between revisions of "Heart Internet"

From WHMCS Documentation

(Activation)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
== About this Module ==
 +
 +
<div class="docs-alert-info">
 +
We removed this module in WHMCS 8.8. Heart Internet discontinued support for its API in February 2023. As a result, this module no longer functions on any version of WHMCS.
 +
</div>
 +
 +
Heart Internet is a UK based reseller web hosting and domain name provider.
 +
 +
<div class="docs-alert-info">
 +
For the Heart Internet domain registration module, see [[Heart Internet Domains]].
 +
</div>
 
{{Provisioning_Module
 
{{Provisioning_Module
 
| changepackage = Yes
 
| changepackage = Yes
Line 4: Line 15:
 
| clientarealink = Yes
 
| clientarealink = Yes
 
| port = 700(live) & 1701(test)}}
 
| port = 700(live) & 1701(test)}}
 +
== Adding a Heart Internet Server ==
 +
 +
To set up a Heart Internet server in WHMCS:
 +
 +
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
 +
# Click '''Add New Server'''.
 +
# Select ''Heart Internet'' from the menu.
 +
# Enter the hostname or IP address.
 +
# Enter the username and password or the access hash. You can obtain your username and password from [https://customer.heartinternet.co.uk/manage/api Heart's API].
 +
# Click '''Continue'''.
 +
# Enter the desired additional server details.
 +
# Click '''Save Changes'''.
 +
# If this is the only Heart Internet server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.
  
==Information==
+
=== Creating a Heart Internet Product === 
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'''.
+
 +
You can create a product that provisions accounts on your Heart Internet server at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products_and_Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.  
  
==Hosting Module==
+
=== WHMCS Connect ===
===Supported Functionality===
 
*Account Creation
 
*Suspension
 
*Unsuspension
 
*Account Termination
 
*Automatic Upgrades/Downgrades
 
*Password Resets (from Client & Admin Area)
 
*Automatic Login
 
  
===Package Setup/Configuration===
+
This module does not support [[WHMCS Connect]].
Begin by going to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > Servers''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''. Add a new server. The name can be anything you want, the module must be set as "Heartinternet" and your Username and 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 '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services''' or, prior to WHMCS 8.0, '''Setup > Products/Services'''. On the '''Module Settings''' tab select "Heartinternet" from the dropdown.  There you'll find two fields: Test Mode and 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.
+
==Troubleshooting==
 
 
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 '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' or, prior to WHMCS 8.0, '''Utilities > Activity Log''' for any errors returned from the API.
 
 
 
==Domain Registrar Module==
 
===Supported Features===
 
{{registrar
 
| notitle = yes
 
| register = yes
 
| transfer = yes
 
| renew = yes
 
| dns = yes
 
| domainsync = yes
 
}}
 
 
 
===Activation===
 
To activate and begin using the Heart Internet registrar module, follow the steps below:
 
 
 
# Login to your WHMCS Admin Area
 
# Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
 
# Locate Heart Internet in the list.
 
# Click the '''Activate''' button.
 
# Enter your Heart Internet API credentials.
 
# Click Save Changes to complete the process.
 
 
 
<div class="docs-alert-info">The API Username and Password can be obtained from https://customer.heartinternet.co.uk/manage/api/</div>
 
 
 
====Test Mode====
 
WHMCS can be configured for testing purposes by ticking the "TestMode" option when configuring Heart Internet as the registrar. This will point all domain related requests to the test environment provided to you by Heart Internet.
 
  
===Automatic Registration===
+
''N/A''
WHMCS allows you to setup automatic domain registration on a per extension basis enabling you to use different registrars for different TLDs to give you the flexibility to offer more extensions and always get the best value.
 
  
To enable automatic registration, please refer to [[Domain Pricing|Configuring Automatic Registration]]
+
{{modules}}
 
 
===Automatic Domain Synchronization===
 
The Heart Internet module supports automatic domain synchronization for syncing of expiry dates and status changes for incoming transfers.
 
 
 
To enable this functionality, you need to ensure you have the '''Domain Sync Enabled''' in Setup > General Settings > Domains and ensure you have the [[Crons#Domain_Sync_Cron|Domain Sync Cron]] configured on your system.
 
 
 
==Troubleshooting==
 
'''Caught exception: Communication failure'''<br>
 
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.
 

Latest revision as of 17:12, 28 August 2023

About this Module

We removed this module in WHMCS 8.8. Heart Internet discontinued support for its API in February 2023. As a result, this module no longer functions on any version of WHMCS.

Heart Internet is a UK based reseller web hosting and domain name provider.

For the Heart Internet domain registration module, see Heart Internet Domains.

Supported Features

Create Suspend Unsuspend Terminate
Yes Yes Yes Yes
Change Package Change Password Usage Updates Client Area Link
Yes Yes No Yes

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

Adding a Heart Internet Server

To set up a Heart Internet server in WHMCS:

  1. Go to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.
  2. Click Add New Server.
  3. Select Heart Internet from the menu.
  4. Enter the hostname or IP address.
  5. Enter the username and password or the access hash. You can obtain your username and password from Heart's API.
  6. Click Continue.
  7. Enter the desired additional server details.
  8. Click Save Changes.
  9. If this is the only Heart Internet server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.

Creating a Heart Internet Product

You can create a product that provisions accounts on your Heart Internet server at Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services.

WHMCS Connect

This module does not support WHMCS Connect.

Troubleshooting

N/A

Server Modules
cPanel/WHM - DirectAdmin - Plesk - Helm 3 - Helm 4 - Ensim - InterWorx - WebsitePanel - Cloudmin
Lxadmin - Virtualmin Pro - XPanel - HyperVM - SolusVM - Cloudmin - WHMSonic - VPS.Net
CentovaCast - SCPanel - MediaCP - GameCP - TCAdmin - Reseller Central - Auto Release - Heart Internet

Registrar Modules
Enom - ResellerClub - Nominet - OpenSRS - ResellOne - OnlineNIC - PlanetDomain - Affordable Domains
TPP Wholesale - TPPInternet - Stargate - Namecheap - NetEarthOne - Bizcn - InternetBS - GMO Internet
12Register - Registercom - DotDNS - WebNIC - Dot.TK - HexoNet - Realtime Register - Registereu
RRPProxy - ResellerCamp - TransIP - Heart Internet - IPMirror - NetRegistry - OVH - VentraIP Wholesale
Email - 101Domain

Fraud Modules
MaxMind - VariLogiX FraudCall - Telesign

Gateway Modules
2CheckOut - AsiaPay - Auth.net Echeck - Authorize.net - Authorize.net CIM - Bank Transfer - BidPay
BluePay - BluePay Echeck - BluePay Remote - Boleto - CashU - CC Avenue - ChronoPay - Direct Debit
EMatters - E-Path - eProcessingNetwork - eWAY Tokens - F2B - Finansbank - GarantiBank - Gate2Shop
Inpay - InternetSecure - IP.Pay - Kuveytturk - Modulo Moip - Mail In Payment - Merchant Partners
Merchant Warrior - IDEALMollie - Moneris - Moneris Vault - Skrill 1-Tap - NaviGate - NETbilling
Netregistry Pay - NoChex - Offline Credit Card - Optimal Payments - PagSeguro - Payflow Pro - Pay Junction
Paymate AU and NZ - Payment Express - PayPal - PayPal Card Payments - PayPal Express Checkout
PayPal Payments - PayPal Payments Pro - PayPoint.net (SecPay) - Payson - Planet Authorize - ProtX VSP Form
PSIGate - Quantum Gateway - Quantum Vault - SagePay - SagePay Tokens v2 - SecurePay
SecurePay AU - Secure Trading - TrustCommerce - USA ePay - WorldPay - WorldPay Invisible