How to Configure Shopping Cart Redirection in the Control Panel
When you want to redirect purchases from an external site to the control panel. This article explains how to configure shopping cart redirection.
When you and/or your Customers log in to their Control Panel, there are several options available to purchase various products and services that you sell. These are buttons or links in the menu or on the pages themselves. These links and buttons need to redirect to your website's shopping cart.
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
- Log in to your Reseller Control Panel.
- In the Menu, point to Settings and then click Branding Settings.
- Click the Control Panel - Shopping Cart Integration tab.
You will be presented with three options for setting up the re-direction URL.
SuperSite
If you select this option, all purchase-related links from within your and your customers' Control Panel will be redirected to your SuperSite.
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 hosted on your website), to which we will redirect you and all your customers when ANY purchase link is clicked within the respective Control Panel.
- Along with the redirection, we will also pass a query string containing parameters that you can use on your website to show appropriate Products and Services. The details of the query string format are mentioned below.
Query String Format
There are two types of redirections that your custom URL may receive:
Your customers may click on a link to purchase a product from 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 to purchase a 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 that you or your Customer wants to buy. The 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
Digital Certificate
digicert
tid=<AuthenticationKey>:
This is a randomly generated authentication token, which you MUST validate to ensure that an authenticated Customer or user is making the redirection. This authentication token is valid only for a short period of time.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 must pass the authentication token as a parameter to the API call mentioned in this article, "Authenticating a Token Passed to a Custom URL."
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 user's role. This variable will be passed only if your customer initiates the product purchase process from within their Control Panel.
- Click the Update button.