Integrating your Website and Shopping Cart with your and your Customers' Control Panel

When you and/or your Customers login to their Control Panel, there are several options available to purchase various products and services that you sell. These are in the form of buttons or links either in the menu or the pages themselves. These links and buttons need to redirect to the Shopping Cart of your website.

You can specify the URL to which you and/or your Customers should be redirected when such links are clicked to buy various Products and Services. This URL should be the URL of the Shopping Cart you are using.

Integrating your and your Customers' Control Panel with your Shopping Cart

  1. Login to your Reseller Control Panel. 1

  2. In the Menu, point to Settings and then click Branding Settings.

  3. Click the Control Panel - Shopping Cart Integration tab.

  4. You will be presented with three options for setting up the re-direction URL:

    • SuperSite 2

      If you select this option, all purchase related links from within your and your Customers' Control Panel will be re-directed to your SuperSite 2. Click on the links below to understand what the SuperSite 2 is and its full potential:

    • SuperSite

      If you select this option, all purchase related links from within your and your Customers' Control Panel will be re-directed to your SuperSite. Click on the links below to understand what the SuperSite is and its full potential:

    • Custom URL

      • If you are NOT using the SuperSite 2 / SuperSite, and have instead integrated with our platform using our API, you should choose this option.

      • If you select this option, you will need to specify a Custom URL (which should ideally be a URL hosted on your website), to which we will redirect you as well as all your Customers when ANY purchase link is clicked within the respective Control Panel.

      • Alongwith the redirection we will also pass a query string containing parameters that you can use on your website to show appropriate Products and Services. Details of the query string format are as mentioned below.

        Query String Format

        There are two types of redirections that your Custom URL may receive:

        • Your Customers may click on a link for purchasing some Product from within their Control Panel.

          The query string in this case will be: <YOUR_SPECIFIED_CUSTOM_URL>?p=<PRODUCT>&tid=<AUTHENTICATION_KEY>&r=customer

        • Your company users, or you may click on a link for purchasing some Product from within your respective Control Panel.

          The query string in this case will be: <YOUR_SPECIFIED_CUSTOM_URL>?p=<PRODUCT>&tid=<AUTHENTICATION_KEY>

        The variables passed as query strings are explained as under:

        p=<PRODUCT>:

        This is the Product which you or your Customer wants to buy. Following are the possible values of this variable:

        Product Name

        Product (p)

        Domain Registration

        domain

        Web Hosting

        hosting

        Email Hosting

        email

        Single Domain Hosting

        singledomainhostinglinux | singledomainhostingwindows

        Multi Domain Hosting

        multidomainhosting | multidomainwindowshosting

        Reseller Hosting

        resellerhosting | resellerwindowshosting | resellerhosting_group

        Enterprise Email

        enterpriseemail

        Enterprise Email Lite

        eelite | eelite_group

        VPS

        vps | vps_group

        Dedicated Server

        dedicatedserver | dedicatedserver_group

        Managed Server

        managedserver

        SiteLock

        sitelock

        CodeGuard

        codeguard

        tid=<AuthenticationKey>:

        This is a randomly generated authentication token which you MUST validate to ensure that the redirection is being made by a authenticated Customer or user. This authentication token is valid only for a short period of time.

        • SOAP API: On the Custom URL you specified above, you must write a script to make an API call to our system to the authenticateLoginID (<authentication key>) method of the Customer class or Reseller Class in the CoreKit, depending upon whether the r variable is passed as a query string. You need to pass the authentication token as parameter to the authenticateLoginID method.

          The method authenticateLoginID (<authentication key>) returns the details of the user who initiated the purchase Order process from within the Control Panel, if the <authentication key> matches and has not timed out. Otherwise, an authentication failure exception will be thrown.

        • HTTP API: On the Custom URL you specified above, you must write a script to make an API call to our system, to authenticate the Customer or user. You need to pass the authentication token as parameter to the API call mentioned here.

          This API call returns the details of the user who initiated the purchase Order process from within the Control Panel, if the <authentication key> matches and has not timed out. Otherwise, an authentication failure exception will be thrown.

        r=customer

        This is the role of the user. This variable will be passed only in the case your Customer is initiating the product purchase process from within their Control Panel.

  5. Click the Update button.