hosting

If the reseller is selling Web Hosting

Web Services (Email Hosting, Web Hosting, Website Builder Plans) Product

firstfoot Interactive Pvt Ltd.'s Web Services Product consists of the following Plan categories:

  • Email Only Plans

  • Windows Web Hosting and Email Plans

  • Linux Web Hosting and Email Plans

  • Website Builder Plans

Under each of the above Plan categories, we have included a default Plan. You may create as many Plans, per your requirement. You may also choose to delete any Plan,
should you no longer wish to offer the same to your Customers.

The pricing model for your Customers and Sub-Resellers differs to some extent:

  • Customers: Customer pricing is based on discounts, depending on the number of months any Plan's Order is purchased
    and renewed for
    . This feature is referred as Telescopic Pricing.

  • Sub-Resellers: Pricing is determined by Pricing Bands.

To Select the Plans you want to Sell to your Customers (Anchor: select)

  1. Login to your Control Panel. See details

  2. In the Menu, point to Settings and click Manage Products and Pricing.

  3. Click the Web Services link.

    By default, there is a Plan created under Email Only Plans, Windows Web Hosting and Email Plans, Linux Web
    Hosting and Email Plans and Website Builder Plans
    . Here, you may:

    • Create New Plans: You may add as many new Plans as you require, by clicking the Create New Plan link under
      each Plan category and saving it.

    • Stop Selling Existing Plans: Upon creating a new Plan, its status is, by default, set to Selling.

      Click the Change link under Selling Status for Customers, select No New Orders and click the Save button.

      This status disallows accepting new Web Services Orders for the Plan from your Customers. However, existing Orders can continue to be Managed and Renewed.

    • Delete Existing Plans: Click the Change link under Selling Status for Customers and
      select Do Not Sell and click the Save button.

Note
  • While you may add several plans under any Plan, your SuperSite can display upto 4 Plans each, under all Plan categories individually. This implies you may display
    simultaneously:

    • upto 4 Email Only Plans.

    • upto 4 Windows Web Hosting and Email Plans.

      Within Windows Hosting Plans, you may set only a maximum of 3 Plans for Windows Hosting (minimum being 1) and 2 Plans for Multi Domain Windows Hosting (minimum being 1).

      Examples:

      • If you have chosen to display 3 Windows Hosting Plans, you would only be able to display any 1 Multi Domain Windows Hosting Plan. You would only be able to display the 2nd Multi Domain Windows Hosting Plan, once you have set the number of Windows Hosting Plans to be displayed to 2.

      • If you have chosen to display 2 Multi Domain Windows Hosting Plans, you would only be able to display any 2 Windows Hosting Plans. You would only be able to display the 3rd Windows Hosting Plan, once you have set the number of Multi Domain Windows Hosting Plans to be displayed to 1.

    • upto 4 Linux Web Hosting and Email Plans.

      Within Linux Hosting Plans, you may set only a maximum of 3 Plans for Linux Hosting (minimum being 1) and 2 Plans for Multi Domain Linux Hosting (minimum being 1).

      Examples:

      • If you have chosen to display 3 Linux Hosting Plans, you would only be able to display any 1 Multi Domain Linux Hosting Plan. You would only be able to display the 2nd Multi Domain Linux Hosting Plan, once you have set the number of Linux Hosting Plans to be displayed to 2.

      • If you have chosen to display 2 Multi Domain Linux Hosting Plans, you would only be able to display any 2 Linux Hosting Plans. You would only be able to display the 3rd Linux Hosting Plan, once you have set the number of Multi Domain Linux Hosting Plans to be displayed to 1.

    • upto 4 Website Builder Plans.

  • The default Plan under each Plan category has unlimited parameters. If you delete this Plan, you may restore it, by simply adding another Plan with unlimited parameters.

  • Any Plan that you create is only visible to your Customers through your SuperSite and not your Sub-Resellers.

  • If you do not want your Sub-Resellers to sell a particular Plan category, you would need to stop offering the Web Services Product entirely.
    See details

Set Web Services Plans Selling Price for Customers (Anchor: plans)

firstfoot Interactive Pvt Ltd. allows you to set Telescopic Price ranges for all Web Services Adds and Renewals for each one
of your Plans. This simply means that you may offer your Customers increased discounts as and when they may choose to add / renew their Web Services Orders with you for multiple months.

Example:

Suppose that your Cost Price for Plan A is USD 5 per month. Depending upon your business model, you may set your Selling Price for 12 months as USD 10 per month. Now, if a Customer
wished to add a Hosting Order under Plan A for 36 months, he would be charged USD 360 (USD 10 per month). However, with the Telescopic Pricing model, you may set a reduced price of say,
USD 8 per month. In this way, your Customer is charged USD 288 instead of USD 360, thus, availing a discount for purchasing for a longer duration.

To Set your Web Services Plans Telescopic Selling Price for Customers

  1. Login to your Control Panel. See details

  2. In the Menu, point to Settings and click Manage Products and Pricing.

  3. Click the Web Services link.

  4. Click the Customers tab under any Plan category.

  5. Click the Manage Price link under the Action column.

  6. Mention the per month Selling Price in each text box as per your requirement.

    Note

    Your Cost Price is determined based on the various resource parameters pricing applicable to you, under various Pricing Bands set by firstfoot Interactive Pvt Ltd..

  7. You may choose to add additional slabs for the duration of the Plan, by selecting it from the drop-down at the bottom of the page and clicking Add Slab.

  8. Click the Update button to save your changes.

Note
  • Pricing for the following parameters can be configured for only the slab of the least duration:

    Plan Name

    Parameter(s)

    All Web Hosting Plans

    Add Dedicated IP/SSL

    Example:

    If you have a Selling Price For 12 Months slab and a Selling Price For 36 Months slab, then you would be able to mention the Add Dedicated IP/SSL Selling Price for only the 12 Months slab.

  • If you have multiple slabs configured, you need to set reduced pricing for the higher duration slab, than the one that is immediately of a lower duration.

    Example:

    If you have a Selling Price For 12 Months slab and add a Selling Price For 36 Months slab, then the per month Selling price you need to mention for the 36 Months slab needs to be lower
    than that of the 12 Months slab.

  • When Specific Pricing is not set, then your Customer would get the best pricing from amongst the Telescopic Pricing (for Web Services) and any ongoing Promotion
    Pricing (if applicable)
    .

    Additional Information

    Understanding Specific Pricing

  • A Plan Name can be customized by clicking the Edit link next to it and submitting a new Plan Name. Plan Name of existing Orders will be updated to reflect the new Plan Name.

  • The SuperSite contains Pricing information about the Products and Services you offer to your Customers. This data is downloaded to your SuperSite
    from your Control Panel and cached (stored) on the SuperSite server. The cache of your SuperSite will be reloaded automatically, once you have completed the above process. This way, the updated details will be downloaded to your SuperSite from your Control Panel.

    Additional Information

    SuperSite

Set Web Services Plans Selling Price for Sub-Resellers (Anchor: set)

Pricing for Web Services Plans for your Sub-Resellers is based on Pricing Bands. Each Pricing Band constitutes various resource parameters such as number of Email Accounts, amount of Data Transfer, etc..

  1. Login to your Control Panel. See details

  2. In the Menu, point to Settings and click Manage Products and Pricing.

  3. Click the Web Services link.

  4. Click the Sub-Resellers tab under any Plan category.

  5. Click the Manage Price link.

  6. Set your Selling Price for each Pricing Band.

  7. Click the Update Pricing button to save your changes.

Note
  • If the price for a Pricing Band has not been set, the pricing set for the next highest Pricing Band will be used.

  • You must enter all the values for the highest Pricing Band.

    For the rest of the Pricing Bands, you may either fill in all the fields or leave all of them blank.

  • Price can be any number (upto 2 decimal places). Hence, 3.00, 3, 3.19 are all valid prices.

  • The pricing in a Pricing Band must be greater than or equal to that of the Pricing Band above it.

    Example:

    The pricing you mention in Band 3 must be greater than Band 2.

  • Pricing for the following parameters can be configured for only Band 1:

    Plan Name

    Parameter(s)

    All Web Hosting Plans

    Add Dedicated IP/SSL

  • Your Sub-Resellers can create their own custom plans and are charged a fixed price per Order as set by you, irrespective of their Selling Price.

  • The PartnerSite contains Pricing information about the Products and Services you offer to your Resellers. This data is downloaded to your PartnerSite from your Control Panel
    and cached (stored) on the PartnerSite server. The cache of your PartnerSite will be reloaded automatically, once you have completed the above process. This way, the updated details will be downloaded to your PartnerSite from your Control Panel.

    Additional Information

    PartnerSite

Maintenance on July 24, 2010

During the following downtime, the firstfoot Interactive Pvt Ltd. Email and Web Hosting Product would be taken offline for upgradation:

Maintenance Window 1

Date: July 24, 2010

Time: 8:30 AM - 2:30 PM (0830 - 1430) GMT/UTC

Duration: 6 hours

Affected Systems: Addition, Renewal, Suspension (for Resellers) of Orders.

Maintenance Window 2

Date: July 24, 2010

Time: 2:30 PM - 3:30 PM (1430 - 1530) GMT/UTC

Duration: 1 hour

Affected Systems: Addition of Orders.

These maintenances shall have no impact on the management and working of your Orders. Please feel free to get in touch with our Support Team at http://billing.techzoneindia.com, in case of any queries/doubts.

Managing DNS, Email, Hosting, Website Builder, SiteLock and CodeGuard through your HTTP API Integration

The following Services reside on separate servers from the ones you connect to, via the HTTP API, due to this, your Customers need to
login to their (individual) Control Panels, for managing such Services:

  • DNS

  • Email (Free Email Account [POP/IMAP] and Email Forwarding)

  • Single Domain Hosting

  • Multi Domain Hosting

  • Reseller Hosting

  • Dedicated Server

  • Enterprise Email

  • Business Email

  • Web Services (Legacy Web Hosting, Email Hosting, Website Builder)

firstfoot Interactive Pvt Ltd. now provides you with another method of directly allowing access to your Customer, to manage the above Products / Services from your interfaces itself.

To accomplish this, you need to pass the following parameters to the mentioned URL, via an HTTP POST method:

URL: https://<Your_Control Panel_Branded_URL>/servlet/ManageServiceServletForAPI

  • auth-token: You need to generate an authentication token, that you need to pass as the value of this parameter for allowing the
    Customer to manage his Order. This can be accomplished by calling the HTTP API Generating a Token method. The generated authentication token will be valid for a very short period of time and you should use it immediately upon generating it.

  • orderid: The Order ID of the Web Services (Legacy Web Hosting, Email Hosting, Website Builder) / Single Domain
    Hosting / Multi Domain Hosting / Reseller Hosting / Dedicated Server / Managed Server / Enterprise Email Order that your Customer wants to manage. In case of DNS, Email Service, the Order ID of the Product associated with the DNS / Email Service needs to be passed. Based on the orderid, the productCategory will be determined.

    Note

    For DNS / Email Service Orders that do not have any other Product associated with them, you can continue to pass the existing orderid to reach the
    DNS Management Console and Email Service Management interface respectively.

  • service-name: This parameter needs to be passed to manage the specified service name. The value of this parameter needs to be
    either:

    • dns: For managing DNS Service.

    • mailfwd: For managing Email Forwarding Service.

    • free_email: For managing Free Email Account Service.

    • webhosting: For managing Web Hosting Service.

    • mailhosting: For managing Email Hosting Service.

    • websitebuilder: For managing Website Builder Service.


    OR

    panel: This parameter needs to be passed to manage WHM. The value of this parameter needs to be whm.

    Note

    For Single Domain
    Hosting / Multi Domain Hosting / Reseller Hosting / Dedicated Server / Managed Server / Enterprise Email Orders, you can pass the corresponding Product Key as the value for this parameter.

    Additional Information

    Product Keys

You would need to create an intermediate interface, which should call the Generating a Token HTTP API method and build a URL
with orderid, auth-token and service-name/panel as parameters, and then redirect the Customer to this URL.

Java Example:

Let us call this interface a servlet named ManageOrderBoxControlPanel.

  1. This interface would accept the Order ID of the Web Services (Legacy Web Hosting, Email Hosting, Website Builder) / Single Domain
    Hosting / Multi Domain Hosting / Reseller Hosting / Dedicated Server / Managed Server / Enterprise Email Order or the Order ID of the Service associated with DNS or
    Email Service as a parameter. So, in order to manage a Service, you will call this interface with
    https://<Your-Server-URL>/ManageOrderBoxControlPanel?orderid=<orderid>.

  2. This servlet would need to call the Generating a Token HTTP API method.

  3. The final URL to which you would then redirect your Customer to, would look like:

    • For management of WHM:
      https://<Your_Branded_URL>/servlet/ManageServiceServletForAPI?auth-token=<auth-token>&orderid=<orderid>&panel=whm

    • For management of DNS Service, Email (Free Email Account [POP/IMAP] and Email Forwarding) Service, Web Services (Legacy Web Hosting, Email Hosting, Website Builder), Single Domain Hosting, Multi Domain Hosting, Reseller Hosting, Dedicated Server, Managed Server, Enterprise Email:
      https://<Your_Branded_URL>/servlet/ManageServiceServletForAPI?auth-token=<auth-token>&orderid=<orderid>&service-name=<servicename>

Get Modify/Upgrade Price

Description

Gets the applicable modify/upgrade price for a particular Web Services Order.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
order-id Integer Required The OrderId for which the details are to be fetched.
new-plan-id Integer Required The new plan to which the Order is to be upgraded/downgraded. To fetch the plan details: plan-id etc., use this method.
months Integer Required The number of months (tenure) in the new plan for which the Order to be placed.

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/webservices/modify-pricing.json?auth-userid=0&api-key=key&order-id=0&new-plan-id=0&months=0

Response

Returns the applicable modify/ upgrade price for a particular Web Services Order.

Example:


{
"upgradecost":0.0,
"modifiedOrderPrice":0.0,
"endtime":"0000000000",
"modifyCostResult":"upgrade",
"remainingmonths":0,
"currentOrderPrice":0.0
}

where

  • currentOrderPrice: The current pricing of the Order for remaining months.

  • modifiedOrderPrice: New applicable pricing of the Order as per the new plan.

  • upgradecost: Actual price applicable i.e. modifiedOrderPrice - currentOrderPrice

Search Orders

Description

Gets a list and details of Orders matching the search criteria.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
no-of-records Integer Required Number of Orders to be fetched.
page-no Integer Required Page number for which details are to be fetched.
order-id Array of Integers Optional Order Id(s) of the Order(s) whose details need to be fetched.
reseller-id Array of Integers Optional Reseller Id(s) whose Orders need to be fetched.
customer-id Array of Integers Optional Customer Id(s) whose Orders need to be fetched.
show-child-orders Boolean Optional Whether Sub-Reseller Orders need to be fetched or not.
status Array of Strings Optional Status of the Order: Active, InActive, Deleted, etc.
domain-name String Optional Name of the Domain of the Web Services Order.
creation-date-start String Optional UNIX TimeStamp for listing of Orders whose Creation Date is greater than creation-date-start.
creation-date-end String Optional UNIX TimeStamp for listing of Orders whose Creation Date is less than creation-date-end.
expiry-date-start String Optional UNIX TimeStamp for listing of Orders whose expiry date is greater than expiry-date-start.
expiry-date-end String Optional UNIX TimeStamp for listing of Orders whose expiry date is less than expiry-date-end.
order-by Array of Strings Optional One or more parameters by which you want to sort the Orders. Default is orderid.

Example:

If page-no is 1, no-of-records is 30 and order-by is orderid; it will fetch the first 30 Orders which suit the search criteria sorted by orderid.
If page-no is 2, no-of-records is 30 and order-by is order id; it will fetch the second batch of 30 Orders sorted by orderid

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/webservices/search.json?auth-userid=0&api-key=key&no-of-records=1&page-no=1

Response

Returns the list of the Orders which match the search criteria.

Getting Order Id

Description

Gets the associated Web Services Order Id from the domain name.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
domain-name String Required The domain name for which the Order Id is to be fetched.

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/webservices/orderid.json?auth-userid=0&api-key=key&domain-name=domainname.asia

Response

Returns the associated Web Services Order Id (Integer) of the domain name.

Get Customer Pricing

Description

Use this method to get details of the pricing for your plans.

Response

Returns a map with the prices of Web Services plans along with the prices of the other products.

The response structure for the Web Services will be:


"productkey":
{
"planid":
{
"action":
{
"tenure-in-months":price
},
"ssl":0.0
}
}

Example:


"hosting":
{
"0":
{
"renew":
{
"12":0.0,
"24":0.0
},
"ssl":0.0,
"add":
{
"12":0.0,
"24":0.0
}
},
"1":
{
"renew":
{
"12":0.0,
"24":0.0
},
"add":
{
"12":0.0,
"24":0.0
}
}
}