HitechcloudPartner Provisioning Module for HostBill

A HostBill provisioning module that integrates with hitechcloudpartner VHI (Virtual Hosting Infrastructure) to manage user account status and synchronization.

Overview

Property	Value
Module Type	Hosting/Provisioning
Version	1.0.0
Author	Atul Mahankal
Base Class	HostingModule

Features

Feature	Status	Description
Test Connection	✅ Working	Verify API connectivity with hitechcloudpartner VHI
Account Suspension	✅ Working	Suspend user accounts on hitechcloudpartner (status=2)
Account Unsuspension	✅ Working	Reactivate suspended accounts (status=1)
Status Synchronization	✅ Working	Sync account status from hitechcloudpartner to HostBill
Account Creation	⚠️ Stub	Returns success without API call (manual linking required)
Account Termination	⚠️ Stub	Returns success without API call

Prerequisites

• hitechcloudpartner user accounts must be created manually on hitechcloudpartner VHI
• Each HostBill client must have their hitechcloudpartner User ID stored in the hitechcloudpartnerid custom field
• The module manages status (suspend/unsuspend/sync) for pre-existing hitechcloudpartner accounts

Requirements

• HostBill (any recent version)
• hitechcloudpartner VHI instance with API access
• Valid App ID and Session credentials from hitechcloudpartner

Installation

1. Copy the hitechcloudpartner folder to your HostBill installation:

   /path/to/hostbill/includes/modules/Hosting/hitechcloudpartner/
   

2. The folder should contain:

   hitechcloudpartner/
   └── class.hitechcloudpartner.php
   

3. Go to HostBill Admin → Settings → Modules → Hosting Modules

4. Activate the "hitechcloudpartner" module

Configuration

App (Server) Setup

Go to Settings → Apps → Add New App and configure:

Field	Description
Host URL	hitechcloudpartner VHI API base URL (e.g., https://api.hitechcloudpartner.example.com)
App Id	Your hitechcloudpartner application identifier
Session	hitechcloudpartner session token for API authentication

Product Setup

1. Go to Settings → Products → Add/Edit Product
2. Select "hitechcloudpartner" as the provisioning module
3. Link to the configured App (server)

Custom Client Field (Required)

This module requires a custom client field hitechcloudpartnerid to link HostBill clients to hitechcloudpartner users.

Settings → Client Custom Fields → Add Field

Property	Value
Field Name	hitechcloudpartnerid
Field Type	Text Input
Description	hitechcloudpartner User ID

How It Works

1. Create hitechcloudpartner user manually on hitechcloudpartner VHI
2. Add client in HostBill and set the hitechcloudpartnerid custom field to the hitechcloudpartner User ID
3. Create order/account in HostBill - the module marks it as created (no API call)
4. Suspend/Unsuspend - module calls hitechcloudpartner API to change account status
5. Synchronize - module fetches status from hitechcloudpartner and updates HostBill

API Endpoints Used

Action	Endpoint	Method
Test Connection	marketplace/app/rest/getchecksum	GET
Get Accounts	billing/account/rest/getaccounts	GET
Set Account Status	billing/account/rest/setaccountstatus	GET

Workflow

See docs/WORKFLOW.md for detailed workflow documentation.

Implementation Details

See docs/IMPLEMENTATION.md for technical implementation details.

Troubleshooting

Connection Test Fails

• Verify the Host URL is correct and accessible
• Check App ID and Session credentials
• Ensure hitechcloudpartner API is responding

Suspension/Unsuspension Fails

• Verify the client has a valid hitechcloudpartnerid custom field value
• Ensure the hitechcloudpartner user exists with that ID
• Check HostBill system logs for API errors

Account Sync Not Working

• Confirm hitechcloudpartnerid is set for the client
• Check if hitechcloudpartner API returns data for that user ID
• Review logs for API response errors

Logging

The module logs to HostBill's system log with the tag "hitechcloudpartner Module". Check logs at:

Reports → Logs → System Log

Limitations

• Account creation is not automated - hitechcloudpartner users must be created manually
• Account termination does not delete users from hitechcloudpartner
• Requires manual linking of HostBill clients to hitechcloudpartner users via hitechcloudpartnerid

License

Proprietary - All rights reserved.