To monitor your data transfer limit you can use the Web Statistics for your website, which Gossimer provides you free of cost. The web statistics, or webstats, provide you detailed information about visits to your website, including the data transfer generated by them (bandwidth). These statistics are generated once a day, and are maintained on an hourly, weekly and monthly basis.
You can view your web stats at http://<yourdomainname>/webstats.
Alternatively, you can monitor your data transfer overages through your Website management interface. To do so, follow the steps mentioned below:
1. Login to your Control Panel and search for the domain name for which you have purchased this hosting package.
2. In the search results view, click on the domain name. This will take you to the order details view.
3. Click on Manage Web Hosting Service in the lower toolbar.
4. In the Website Management interface pop-up that follows, you will see Usage statistics for your website, which also includes the data transfer (in Mb/month).
Tags: 3 Web, Bandwidth, Control Panel, Details View, Domain Name, http, Lt, Manage Web Hosting Service, Management Interface, Usage Statistics, View 3, Web Hosting Service, Web Service, Web Statistics, web stats, Website Management
When a user attempts to connect to a Web site and an HTTP error occurs, a generic message is sent back to the client browser with a brief description of what happened during the attempt to establish a connection. For example, if a user attempts to connect to a page that no longer exists on the Web site, an HTTP error will be returned in the form of an HTML page that contains the statement The requested URL was not found on this server.
You can use the Custom Error Pages view to customize HTTP errors that are sent to clients when Web server errors occur. Following is a list of HTTP errors you can customise:
401 – Authorization Failed
The request requires user authentication, typically a Username/Password credential pair. If the request already included Authorization credentials, then the 401 response indicates that authorization has been refused for those credentials.
403 - Permission Denied/Forbidden
You tried to access a URL for which you don’t have permission.
404 – File / Resource Not Found
Your browser cannot locate the document corresponding to the URL you entered. An improperly typed URL is usually the cause.
406 - Resource Not Acceptable
It’s possible you have requested a page that contains files which your browser has indicated to the server that it cannot accept, e.g. a multimedia file that your browser cannot process. Your browser sends information about what files it can accept to the server (in the HTTP header) as part of a request. You might check the preferences settings of your browser to see if there are file types it is not accepting.
500 – Internal Error
The server encountered an unexpected condition which prevented it from fulfilling the request.
To customize the error messages, follow the procedure below:
1. Create your custom Error message and upload it to your website.
2. Login to your Control Panel and search for the domain name for which you have purchased this hosting package. Click here to read how >>
3. In the search results view, click on the domain name. This will take you to the order details view.
4. Click on Manage Web Hosting Service in the lower toolbar.
5. In the Website Management interface pop-up that follows,
go to Manage Website -> Custom Error Pages, if you have a Windows web hosting package
or
go to Manage Website -> Web Server Manager -> Custom Error Pages, if you have a Linux web hosting package
6. For the HTTP error that you wish to customize, you can
If for some reason you wish to disable custom error message for a particular error, select the radio button adjacent to Set To Default for that error.
7. Click on Submit to save the settings.
In order to complete the action in case of Linux Hosting, the Web Server needs to be restarted. Random restarts affect other services running on the Server. In order to avoid this, the Server has been scheduled to restart at intervals of 20 minutes. Hence, the changes might take upto 20 minutes to be effective.
Tags: HTML, http, Linux, Manage Web Hosting Service, Microsoft Windows, Web Hosting package, Web Server, Web server errors, Web Server Manager
FTP exists primarily for the transfer of data between two end points. FTP differs from HTTP (Hyper Text Transfer Protocol, used for serving websites via web browsers) fundamentally as it is an application made up of two distinct TCP connections:
1. Control connection: This TCP-based connection is used to provide a communications channel for the delivery of commands and replies. This is effectively the mechanism that enables the user to tell the server which file is being requested, which directory it is in, and so forth.
2. Data connection: The second TCP-based connection is used for the actual transfer of user data. Once the Control connection has been used to exchange information on which file is required, the Data connection is used to transfer the file between the client and server.
Using these two communication connections, two distinct modes of operation determine in which direction the connections are established: Active mode and Passive mode.
FTP is a TCP based service exclusively. There is no UDP (User Datagram Protocol transports data as a connectionless protocol, using packet switching) component to FTP. FTP is an unusual service in that it utilizes two ports, a Data port and a Command port (also known as the Control port). Traditionally these are port 21 for the Command (Control) port and port 20 for the Data port. The confusion begins however, when we find that depending on the mode, the data port is not always on port 20.
Active FTP
In active mode FTP the FTP client software connects from a random unprivileged (unprivileged port is a port which is higher than 1023) port. Let’s say N is the FTP server’s command port, port 21.
Then, the client starts listening to port N+1 and sends the FTP command PORT N+1 to the FTP server. The server will then connect back to the client’s specified data port from its local data port, which is port 20.
Here in this mode of FTP, Gossimer doesn’t need to open any additional non-secure ports on our servers firewall and hence is secure from the server-side.
Passive FTP
In passive mode FTP, the FTP client initiates both connections to the server. When opening an FTP connection, the client opens two random unprivileged ports, lets say N and N+1. The first port contacts the server on port 21, but instead of then issuing a PORT command and allowing the server to connect back to its data port, the client will issue the PASV command. The result of this is that the server then opens a random unprivileged port lets say P and sends the PORT command back to the client. The client then initiates the connection from port N+1 to port P on the server to transfer data.
This method of FTP is insecure, as a random unprivileged port is opened on the Server. This is a potential security issue and it isn’t advisable to use the Passive mode of FTP.
IMPORTANT
All Gossimer Windows and Linux web servers support both Active as well as Passive modes.
All popular FTP software allow users to select the data connection mode (Active or Passive), when uploading/downloading data to a web server.
Reference:
Click here to read how to set data connection mode in CuteFTP >>
Click here to read how to set data connection mode in 3D-FTP >>
Click here to read how to set data connection mode in CoreFTP >>
Click here to read how to set data connection mode in SmartFTP >>
Click here to read how to set data connection mode in WS_FTP >>
Tags: Client Software, Command port, Communication Connections, Communications Channel, Confusion, Connectionless Protocol, Control port, Data port, Distinct Modes, Firewall, Ftp Client Software, Ftp Command, Ftp Port, Ftp Server, Ftp Software, Gossimer, http, Hyper Text Transfer, Hyper Text Transfer Protocol, Linux, Microsoft Windows, Modes Of Operation, packet switching, Passive Mode Ftp, Ports, Tcp Connections, Text Transfer Protocol, Transports, UDP, User Datagram Protocol, Web Browsers, Web Server, Web Servers
A sub-domain is a subdivision of a Domain Name. While Domain Names need to be Registered with a Registrar, sub-domains are not and an unlimited number of sub-domains can be created through Managed DNS service. For example, a sub-domain news.yourdomain.com can be created on the Domain Name yourdomain.com.
Gossimer allows you to create unlimited sub-domains with your Linux Web Hosting package, by adding a Star (*) Address (DNS) Record for your Domain Name through the Managed DNS Order (that is included for free with your Web Hosting package). When a visitor reaches http://<sub-domain>.yourdomain.com, he is served the content from http://yourdomain.com/sub-domain/. Let’s discuss this with a few examples:
If someone typed http://news.yourdomain.com/php (without the trailing forward slash), he would receive a Page not found error.
1. If you are using our Managed DNS Service, then we have already created the appropriate Star Record to allow sub-domains on your Web Hosting package to begin working, once you modify your Name Servers to ours. Click here to find information about which Name Servers to use for activating your sub-domain hosting >>
If you are not planning to use our Managed DNS Service, then you need to add a Star Record to allow sub-domains on your Web Hosting package to begin working. Click here to find information about what DNS Records to add on your own Name Servers for activating your sub-domain hosting >>
2. If you have created an Alias for your Web Hosting package and want sub-domains of each alias to also point just like your hosted Domain Name, then you need to create a Star DNS Record for each aliased Domain Name, to point to your hosted Domain Name.
Example:
Suppose you have a Linux Web Hosting package for yourdomain.com and also a sub-domain news.yourdomain.com. Then say, you decide to set an alias for this package as yourotherdomain.com. To accomplish this, all you need to do is create an Address Record (DNS) for yourotherdomain.com to point to the IP Address of yourdomain.com.
yourotherdomain.com IN A 86400 1.1.1.1 (assuming that this is the IP Address of yourdomain.com)
But say you want news.yourotherdomain.com to function as well, then you would instead need to create a Star Address Record (DNS) for yourotherdomain.com
*.yourotherdomain.com IN A 86400 1.1.1.1 (assuming that this is the IP Address of yourdomain.com)
The Managed DNS Service for yourotherdomain.com could either be purchased through Gossimer or with your current DNS Service Provider.
Reference:
Click here to know what a Domain Alias is >>
Click here to know how to add Domain Aliases to your Web Hosting package >>
Click here to know the IP Address of your Web Hosting package where your Aliased Domain Name needs to point >>
3. If someone types http://php.news.yourdomain.com in the browser, then our web server will try to fetch the content from http://yourdomain.com/php.news/
If you want http://php.news.yourdomain.com to forward to http://yourdomain.com/news/php/, then you would need to add an alias for yourdomain.com as news.yourdomain.com (assuming that the Star Address Record for yourdomain.com exists).
Reference:
Click here to know what a Domain Alias is >>
Click here to know how to add Domain Aliases to your Web Hosting package >>
Tags: DNS, HTML, http, Linux, Managed DNS Service, Php, Registrar, the Star, Web Hosting package, Web Server
Common API Examples
| Title: | registerDomain method under DomOrder class of Domains kit |
| Description: | The registerDomain method accepts complex variable/parameters whose usage cannot be easily illustrated using HTML forms. Hence, this feature cannot emulated from within your Reseller Control Panel through the Settings -> API -> Emulate API Calls -> Domains API Kit Emulator interface. |
| Solution: | An example of XML sent and received for this method is provided below for reference. |
| Example XML: | XML Sent:
<?xml version=”1.0″ encoding=”UTF-8″?> XML Received: <?xml version=”1.0″ encoding=”UTF-8″?> |
Common API Errors and their Solution
| Title: | Sending Integers as numbers rather than as strings |
| Description: | Due to the limitations of Java, we cannot accept integers (e.g. 1) as numbers in a hash, rather they must be sent to us as strings (i.e. “1″). This is a recurrent problem when using the PHP Kit since PHP puts in Integers as plain numbers (in a hash). |
| Solution: | Ensure that you’re sending in numbers as strings |
| Example XML: | XML Sent:
POST /anacreon/servlet/rpcrouter HTTP/1.0 User-Agent: NuSOAP/0.6.7 (1.7) Host: www.myorderbox.com Content-Type: text/xml; charset=ISO-8859-1 SOAPAction: “” Content-Length: 1543 <?xml version=”1.0″ encoding=”ISO-8859-1″?><SOAP-ENV:Envelope SOAP-ENV:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/” xmlns:SOAP-ENV=”http://schemas.xmlsoap.org/soap/envelope/” xmlns:xsd=”http://www.w3.org/2001/XMLSchema” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:SOAP-ENC=”http://schemas.xmlsoap.org/soap/encoding/” xmlns:si=”http://soapinterop.org/xsd” xmlns:impl=”com.logicboxes.foundation.sfnb.order.DomOrder” xmlns:apachesoap=”http://xml.apache.org/xml-soap”><SOAP-ENV:Body><impl:regis terDomain xmlns:impl=”com.logicboxes.foundation.sfnb.order.DomOrder”><userName xsi:type=”xsd:string”>xxxxx@zzz.com</userName><password xsi:type=”xsd:string”>xxxxx4</password><role xsi:type=”xsd:string”>reseller</role><langpref xsi:type=”xsd:string”>en</langpref><parentid xsi:type=”xsd:int”>1</parentid><domainHash xsi:type=”apachesoap:Map”><item><key xsi:type=”xsd:string”>fbc-elroy.com</key><value xsi:type=”xsd:int”>1</value></item></domainHash><ns xsi:type=”apachesoap:Vector”><item xsi:type=”xsd:string”>ns11.zzz.com</item><item xsi:type=”xsd:string”>ns12.zzz.com</item></ns><registrantContactId xsi:type=”xsd:int”>1548641</registrantContactId><adminContactId xsi:type=”xsd:int”>1548641</adminContactId><techContactId xsi:type=”xsd:int”>1548641</techContactId><billingContactId xsi:type=”xsd:int”>1548641</billingContactId><customerId xsi:type=”xsd:int”>321841</customerId><invoiceOption xsi:type=”xsd:string”>NoInvoice</invoiceOption></impl:registerDomain></SOAP- ENV:Body></SOAP-ENV:Envelope> XML Received: HTTP/1.0 500 Internal Server Error Server: Resin/3.0.s041002 Content-Type: text/xml; charset=utf-8 Date: Fri, 10 Jun 2005 16:40:04 GMT <?xml version=”1.0″ encoding=”UTF-8″?> <soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/” xmlns:xsd=”http://www.w3.org/2001/XMLSchema” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”> <soapenv:Body> <soapenv:Fault> <faultcode>soapenv:Server.userException</faultcode> <faultstring>com.logicboxes.error.LogicBoxesException#~#com.logicboxes.util. Util#~#java.lang.Integer#~#error#~#</faultstring> <detail/> </soapenv:Fault> </soapenv:Body> </soapenv:Envelope> |
| Title: | Incorrect Parent ID |
| Description: | An incorrect parent id is passed when trying to connect to the server |
| Solution: | Pass the correct parent id. You might be passing the one for demo while connecting to the live environment, or vice-versa. |
| Example XML: | Error Received:
Error Code: 2, SOAP raised an error. Error Details: |
| Title: | Maximum Number of Connections to the Registry Exceeded |
| Description: | When too many users send commands to the same Registry using a particular Registrar’s connections, then an error would be displayed |
| Solution: | This is a temporary issue and you need to simply try after sometime. Since the Registry provides each Registrar with a set number of connections, when these get exhausted an exception is thrown. |
| Example XML: | Error Received:
01-jul-2005 16:43:31 org.apache.axis.client.Call invoke |
| Title: | Error received when making https calls using the .NET API Kit |
| Description: | You may receive an error when trying to make an https call using our .NET API Kit since your .NET API Client needs to set a system security property to allow the system to accept SSL certificates. |
| Solution: | You need to add a class in your project (or the .NET Examples that we provide) having the following lines of code: Imports System.Security.Cryptography.X509CertificatesPublic Class TrustAllCertificatePolicy
Implements System.Net.ICertificatePolicy Public Sub New() End Sub Public Function CheckValidationResult(ByVal srvPoint As System.Net.ServicePoint, ByVal certificate As System.Security.Cryptography.X509Certificates.X509Certificate, ByVal request As System.Net.WebRequest, ByVal certificateProblem As Integer) As Boolean Implements System.Net.ICertificatePolicy.CheckValidationResult Return True End Function End Class
Also the user needs to include the following line of code before making the any function call to the https URL: System.Net.ServicePointManager.CertificatePolicy = New TrustAllCertificatePolicy We would suggest that you include the above line in the NetAPI.vb class constructor. After performing all the above steps, you would be able to make the https calls using the .NET API Kit without any error. |
| Example XML: | Error Received
System.Net.WebException: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel. —> System.Security.Authentication.AuthenticationException: The remote certificate is invalid according to the validation procedure. |
Tags: Api, Api Calls, Api Examples, C Ommon, CheckValidationResult(ByVal srvPoint As System.Net.ServicePoint ByVal certificate As System.Security.Cryptography.X509Certificates.X509Certificate ByVal request As System.Net.WebRequest ByVal certific, Class TrustAllCertificatePolicy Implements System.Net., Cryptography, HTML, Html Forms, http, Impl, Interface Solution, Java, Kit Description, Lt Xml, Parent, particular Registrar, Php, Reference Example, Registerdomain, Registrar, Reseller Control Panel, Schemas, Sfnb, SSL, System.Net., Utf 8, Variable Parameters, Vector, www.myorderbox.com, Xml, Xml Soap, Xsi, Xxxxx, Zzz
Gossimer maintains detailed daily logs of traffic visiting your SusperSite and PartnerSite websites. These website statistics are graphically displayed within your SuperSite and PartnerSite Website Statistics Area, for you to analyze traffic trends such as:
It is imperative that you set a Username and Password for your SuperSite and PartnerSite Web Statistics area, before being able to gain access to the same. Click here to know how you can add your Web Statistics Area Username and Password >>
There are three methods of viewing your SusperSite and PartnerSite Website Statistics:
I. From your Reseller Control Panel
1. Login to your Reseller Admin Control Panel from http://manage.gossimer.biz/reseller.
2. To view your SuperSite Website Statistics, or PartnerSite Website Statistics, go to
Settings -> SuperSite & PartnerSite -> View SuperSite Stats
Settings -> SuperSite & PartnerSite -> View PartnerSite Stats
This will open the respective Statistics Area in a new window.
II. From the Supersite or PartnerSite URL
1. Go to http://<your supersite URL>/admin, or http://<your partnersite URL>/admin, as applicable.
2. Enter the Username and Password to your Reseller Account, and click on Submit.
3. Click on the link Other Misc Functions and then, click on the View Detailed Website Statistics of your SuperSite/PartnerSite link. This will open the respective Statistics Area in a new window.
III. By directly visiting the SuperSite and PartnerSite Website Statistics Area
If you know your Reseller Id (a unique number available in your Reseller Admin Control Panel under Settings -> Primary Profile), then you may visit the following URLs directly:
SuperSite Statistics Area -> http://<your Reseller Id>.stats.supersite.myorderbox.com/
PartnerSite Statistics Area -> http://<your Reseller Id>.stats.partnersite.myorderbox.com/
Tags: Admin Control Panel, Amp, Control Panel 1, Duration, Gossimer, Hosts List, http, Ip Addresses, Logs, Lt, Reseller Account, Reseller Control Panel, Robots, Rush Hours, Search Engines, Supersite, Traffic Trends, Type Os, Unique Visitors, Web Statistics, Web Statistics area, Web Statistics Area Username, Website Statistics
Your Company Users can login into their respective Control Panels from your Branding URL, followed by their Role [Support/Billing/Sales], as explained below:
Support User Login URL – http://<YOUR_BRANDED_URL>/support
Billing User Login URL – http://<YOUR_BRANDED_URL>/billing
Sales User Login URL – http://<YOUR_BRANDED_URL>/sales
You can retrieve your Branded URL from your Reseller Admin Control Panel -> Settings -> Storefront & Control Panel -> URL. Please read to learn more about managing your Branded URL.
Tags: Admin Control Panel, Amp, http, Login Details, Lt, Storefront, Url
If you already have a website entertaining your existing clients, Gossimer even allows you to integrate the essential Storefront features with your website, enabling your Customers and Sub-resellers to access all your products and services via your website.
All you have to do is copy the script for the feature that you wish to integrate, and paste it to your site. The major features that you would wish to integrate are listed here.
You can integrate Customer Login as well as Reseller Login with your website. You need to put in the following code to integrate the Login with your Website –
<Your Reseller Id> - You can get your Reseller Id from your Control Panel by going to Settings -> Personal Information -> Primary Profile. Here the first field is the Reseller Id, the value of which you need to put in here.
<role> - If you are integrating Reseller Login, then you need to put in role as Reseller and if you want Customer Login, then put the role as Customer.
Integrating New Domain Purchase [Check Availability] Tool with your website
The steps for buying a New Domain Name are as follows:
1. Checking Domain Availability
2. Filling the Domain Order Form
3. Payment Process
4. Actual Registration
Of these steps, you can choose to have the Check Availability box at your end on your website or on the Reseller Storefront Server.
In order to directly link to the Check Availability page use the link below -
http://<#YOUR BRANDED URL#>/servlet/CheckAvailabilityServlet?actionkey=add
Replace <#YOUR BRANDED URL#> in the above URL with your Branded URL, which you can find at Settings -> Storefront & Control Panel -> URL, in your Reseller Control Panel. This will bring up the Check Availability box from where any of your Customers can start placing an Order for a Domain Name.
If, however, you wish to have the Check Availability box on your server as a part of your website, you can use either of the Check Availability form codes given below.
<form name=”ChkAvailForm” action=_quot;http://<#YOUR BRANDED URL#>/servlet/CheckAvailabilityServlet” method=”get”><br>
<input type=hidden name=”suggestalternatives” value=”true”><br>
<input type=hidden name=”validatenow” value=”true”><br>
<input type=hidden name=”actionkey” value=_quot;add_quot;_gt;_lt;br_gt;
<p align=”center”>www.<input name=”domainname” value=”" size=”20″><br>
<select name=”tld”><br>
<option value=”.biz”>.biz</option><br>
<option value=”.info”>.info</option><br>
<option value=”.com” selected>.com</option><br>
<option value=”.net”>.net</option><br>
<option value=”.org”>.org</option><br>
<option value=”.us”>.us</option><br>
<option value=”.name”>.name</option><br>
<option value=”.in”>.in</option><br>
<option value=”.co.in”>.co.in</option><br>
<option value=”.net.in”>.net.in</option><br>
<option value=”.org.in”>.org.in</option><br>
<option value=”.firm.in”>.firm.in</option><br>
<option value=”.gen.in”>.gen.in</option><br>
<option value=”.ind.in”>.ind.in</option><br>
</select><br>
<br><br>
<input type=”submit” value=”Check”><br>
</form>
OR
<form name=”ChkAvailForm” action=_quot;http://<#YOUR BRANDED URL#>/servlet/CheckAvailabilityServlet” method=”post”><br>
<input type=hidden name=”suggestalternatives” value=”true”><br>
<input type=hidden name=”validatenow” value=”true”><br>
<input type=hidden name=”actionkey” value=_quot;add_quot;_gt;_lt;br_gt;
<p align=”center”>www.<input name=”domainname” value=”" size=”20″><br>
<input type=checkbox name=”tld” value=”com”>.com
<input type=checkbox name=”tld” value=”net”>.net
<input type=checkbox name=”tld” value=”org”>.org
<input type=checkbox name=”tld” value=”info”>.info
<input type=checkbox name=”tld” value=”biz”>.biz
<input type=checkbox name=”tld” value=”us”>.us
<input type=checkbox name=”tld” value=”name”>.name
<input type=checkbox name=”tld” value=”.in”>.in
<input type=checkbox name=”tld” value=”co.in”>.co.in
<input type=checkbox name=”tld” value=”net.in”>.net.in
<input type=checkbox name=”tld” value=”org.in”>.org.in
<input type=checkbox name=”tld” value=”firm.in”>.firm.in
<input type=checkbox name=”tld” value=”gen.in”>.gen.in
<input type=checkbox name=”tld” value=”ind.in”>.ind.in
<br><br>
<input type=”submit” value=”Check”><br>
</form>
Integrating the Domain Name Transfer Link with your website
If any Customer of yours wishes to Transfer their Domain Name from their Current Registrar to us, you can simply point them to the below link or you can have this link on your Website. Replace <#YOUR BRANDED URL#> WITH Your Branded URL [in your Reseller Control Panel go to Settings -> Branding -> Storefront & Control Panel -> URL]:
http://<#YOUR BRANDED URL#>/servlet/CheckAvailabilityServlet?&actionkey=transfer.
Integrating the Whois Lookup tool on your website
You can integrate the Whois Lookup into your website in two ways:
In order to directly link to the Whois Lookup page use the link below. Replace <#YOUR BRANDED URL#> WITH Your Branded URL, available at Settings -> Storefront & Control Panel -> URL, in your Reseller Control Panel.
http://<#YOUR BRANDED URL#>/whois?
If however you wish to have the Whois Lookup box on your server as a part of your website, you can use the Whois Form code given below. Substitute <#YOUR BRANDED URL#> with your Branded URL.
<form name=”WhoisForm” action=_quot; http:// <#your BRANDED URL#>/servlet/WhoisServlet” method=”get”>
<input name=”domainname” value=”">
<br>
<input type=”submit” value=”Whois Lookup”>
</form>
The StoreFront is now DEPRECATED and will be removed shortly. All Resellers are encouraged to stop using the Storefront and begin using the new powerful SuperSite and PartnerSite.
Tags: Amp, Branding, Current Registrar, gen., Gossimer, http, Input Type Text, Lt, Major Features, Pid, Profile, Quot, Reseller Control Panel, Reseller Id, Reseller Login, Resellers, Storefront, Type Password, Url, www.foundationapi.com/servlet/AuthenticationServlet_quot
Integration of 2Checkout version 1 and version 2 Credit Card Payment Gateway with your Reseller Account is identical. The Integration process does not involve ANY code writing, and all you need to do is fill up a form specifying your Account Details and Payment Collection preferences.
Before you Start
You need to ensure that you are an 2Checkout Merchant. You can signup for a Merchant Account from – https://www2.2checkout.com/2co/signup
Setup the Return URL within your 2Checkout Merchant Account
a. Login into your 2Checkout Merchant Account
b. Click on the 7. Setting Up Your Site. link
c. Scroll down to the Optional Parameters section and click on the link under Click here
d. Set both your Pending and Approved URLs as:
http://<Your_Control Panel_Branded_URL>/reseller/paymentgateway/generic/PostFormGateway.jsp?PGNAME=2checkout
* You need to replace <Your_Control Panel_Branded_URL> with the URL you have set within your Reseller Control Panel under Settings -> Storefront & Control Panel -> URL.
e. Click on the Save Changes button to submit these changes.
Submit your Account Details and Preferences to us
1. Login into your Reseller Control Panel from
2. Click on the Settings -> Finance & Billing -> Payment Gateway -> List / Add
3. Click on the Add Payment Gateway button and then on either the Add a 2Checkout Credit Card Gateway or Add a 2Checkout Version 2 Credit Card Gateway link, depending upon the version of your 2Checkout Merchant Account.
4. Enter the following 2Checkout Details and save your changes by clicking on the Submit button
Gateway Name - This Gateway Name would be shown to your Customers / Sub-Resellers, when they are about to make Payment. You can use something like “Credit Card Payment” or “Visa/Master Card” etc.
Vendor Id - The Vendor Serial Number assigned by 2Checkout when you create a Merchant account with them.
Secret Word - The security code (word) for your Merchant Account with 2Checkout.
Currency – Currently we allow 2Checkout to charge your Customers / Sub-Resellers only in US Dollar (USD).
Currency Exchange Rate – If the Currency you selected in the previous option varies from your Selling Currency, we will have to convert the Invoice Value to the 2Checkout Currency, BEFORE we send your Customer to 2Checkout. For this purpose the system needs a exchange rate between the two.
You may choose to maintain this exchange rate yourselves or let us maintain it for you. We download forex rates on a daily basis from a recognized source and update exchange rates for you. If however you wish to update the rates yourselves then you may do so by selecting the I would like to Maintain the currency exchange rate myself checkbox AND entering your own conversion rates.
Select the types of CREDIT CARD that your Merchant Account Supports: You need to select the types of Credit Card that are supported by your 2Checkout Merchant Account. The credit card types available are – Visa, Master, Amex, Discover, Diners Card and JCB. You can also decide the sequence in which you want your Customers / Sub-Resellers to view these Card types.
Payment Gateway Access Level for Customers and Sub-Resellers – Click here to know more about Payment Gateway Transaction types and Access Levels for your Customers and Sub-Resellers >>
Deciding whether a Sub-Reseller and Customer is Credited with the Gross Amount or Net – Your Bank and 2Checkout deducts a fee on a per transaction basis. There are two types of Transactions that can pass through your 2Checkout integration – Invoice/Debit Note Payment, and Add Funds. Click here to know more about Payment Gateway Transaction types and Access Levels for your Customers and Sub-Resellers >>
In case of an Add Funds Transaction, you have the option of crediting your Customers/Sub-Resellers with the NET Amount that 2Checkout credits you with, or choose to credit them with the gross funds and bear the charges yourselves. The NET Amount is calculated by subtracting the per transaction charges from the Transaction Amount. The per transaction charges are calculated by adding the Total Fixed fee charged per transaction and the Total Variable fee charged per transaction.
Total Fixed fee charged per transaction for your merchant account (Per Transaction Fixed Fee charged by your Bank + Per Transaction Fixed Fee charged by the 2Checkout Credit Card Gateway) - Enter the total fixed fee that is charged per transaction in the given textbox. This information is primarily used to calculate the Net Amount that your merchant account is credited with, if you choose to credit your customer / sub-reseller with the Net Amount in an Add funds Transaction. Your bank and/or your gateway may be charging you a different amount of fixed fee per transaction for different credit card types e.g. a certain fixed fee per transaction for Visa cards and a different fixed fee for American Express cards. In case, the amount of fixed fee is different per credit card type, then enter the highest amount of fixed fees charged per transaction to your account e.g. if the total fixed fee for Visa Cards is 25 cents per transaction and the total fixed fee for American Express cards is 30 cents per transaction, then enter 0.30 in the textbox. If there is no fixed fee charged per transaction then enter 0.
Total Variable fee charged per transaction for your merchant account - Enter the total variable fee that is charged per transaction in the given textbox. This information is primarily used to calculate the Net Amount that your merchant account is credited with, if you choose to credit your customer / sub-reseller with the Net Amount in an Add funds Transaction. Your bank and/or your gateway may be charging you a different amount of variable fee per transaction for different credit card types e.g. a certain variable fee per transaction for Visa cards and a different variable fee for American Express cards. In case, the amount of variable fee is different per credit card type, then enter the highest amount of variable fees charged per transaction to your account e.g. if the total variable fee for Visa Cards is 2.50% per transaction and the total variable fee for American Express cards is 3.00% per transaction, then enter 3.00 in the textbox. If there is no variable fee charged per transaction then enter 0.
IMPORTANT
If you have selected to credit a Customer/Sub-Reseller with the Net Amount in an Add Funds transaction, then you must submit either a Fixed Transaction fee (greater than 0) or a Variable Transaction fee (greater than 0).
Send me a Reminder if a transaction is pending for more than x days – In case you have not yet accepted a payment sent to you via the 2Checkout Payment Gateway, you can get e-mail reminders sent across to you from our system, after every x number of days, until you either Approve or Decline these payments. Click here to know how to Approve / Decline Payment Gateway transactions >>
Display Position – If you plan on adding Multiple Gateways you can select the position in which you wish to display this Gateway on your Payment Page.
IMPORTANT
The SuperSite contains information about the various Payment options you offer to your Customers and also presents these options at the time of purchasing Products and Services. This data is downloaded to your SuperSite from your Control Panel and cached (stored) on the SuperSite Server. Hence, you would need to refresh the cache of your SuperSite once you have completed the above process. You can accomplish this from within your Control Panel itself by clicking on Tools -> Reload SuperSite & PartnerSite Cache -> SuperSite Payment Preferences. Click here to know what is SuperSite >>
Tags: 2checkout, Account Details, American Express, bank, cent, Code Word, Credit Card Gateway, Credit Card Payment, Gateway Link, http, Jsp, Merchant Account, Optional Parameters, Payment Gateway, Reseller Account, Reseller Control Panel, Resellers, Return Url, Secret Word, Security Code, Serial Number, Storefront, Vendor Id, Visa Master Card
Follow the instructions below to begin integration with the API using .NET.
Make sure you have read the General API Integration Instructions first. If you have already integrated the .NET API Kit at your end, read the Change Log first to know what has changed since.
Reference:
General API Integration Instructions >>
Change Log >>
Step 1. Download the API Kit
Click the link below to download the relevant API kits (updated on 6th March, 2008).
Option 1 – Setup Application
NET_Core_Setup_v3_10.zip
NET_Domains_Setup_v3_10.zip
NET_Hosting_Setup_v3_10.zip
NET_OtherProducts_Setup_v3_10.zip
Option 2 – Compressed ZIP File
NET_CoreExamples_v3_10.zip
NET_DomainsExamples_v3_10.zip
NET_HostingExamples_v3_10.zip
NET_OtherProductsExamples_v3_10.zip
Step 2. Download the API Documentation
The complete documentation of all classes and methods available in the API can be found in the Docs below. The Docs below are javadocs, but the function names and explanations remain the same for all the platforms and the documentation is self explanatory. We recommend you download the docs and read through them completely once before you integrate your application (updated on 6th March, 2008).
Core_Docs_v3_10.zip
Domains_Docs_v3_10.zip (updated on 1st April, 2008)
Hosting_Docs_v3_10.zip
OtherProducts_Docs_v3_10.zip
Step 3. Install the API Kit
There are two ways by which you may install the API Kit on your computer:
Option 1 – Setup Application
We recommend that you download, unzip and run the setup file. First, however, please be sure that you have administrator privileges to install applications on the computer. If you’re hosting your website with a third-party provider and do not have the rights to install applications, then you will not be able to use the setup application to install the kit. Therefore, you may manually install and use the required API files from our compressed ZIP file option (Refer to Option 2 below).
The setup application will perform the following tasks:
A .NET dll containing the kit, and the relevant documentation, will be placed inside your “Program Files” folder; by default, the path would be “C:Program Files”. Therefore, you should be able to find the DLL and the documentation corresponding to your kit. Please ensure that you have the .NET runtime installed before you attempt to use the API kit.
Relevant shortcuts will be placed in your start menu.
If you have Microsoft Internet Information Server version 5.0 or greater (IIS) installed, the setup file will create a virtual directory named as OrderBoxCoreExamples , OrderBoxDomainsExamples, OrderBoxHostingExamples, OrderBoxOtherProductsExamples in your “Default Web Site”. The setup file allows you to give the virtual directory any name of your choice. This virtual directory contains a Visual Studio .NET project called OrderBoxCoreExamples , OrderBoxDomainsExamples, OrderBoxHostingExamples, OrderBoxOtherProductsExamples, which illustrates every function provided in the OrderBox API. You may run the examples by either by:
Opening it in Visual Studio.Net and pressing the F5 key, or
Visiting the url http://localhost/examples/ in your browser.
Option 2 – Compressed ZIP File
Download the zip file and extract the files to any temporary folder. The temporary folder will now contain the following subfolders:
OrderBoxCoreExamples , OrderBoxDomainsExamples, OrderBoxHostingExamples, OrderBoxOtherProductsExamples – The folder contains the example files to illustrate every method in the kit.
bin – This folder contains the actual kit DLL file. This is a .NET DLL, and requires the .NET runtime to be pre-installed, for use.
Installing the examples on your own computer:
Create the Examples folder (OrderBoxCoreExamples , OrderBoxDomainsExamples, OrderBoxHostingExamples, OrderBoxOtherProductsExamples) inside the root of any website configured in IIS, on your computer. IIS contains a default website called “Default Web Site”, having it’s root folder set to “c:Inetpubwwwroot”. If you have a default installation of IIS, you would create a subfolder called “examples” inside that root folder. Please note that you may name the examples directory as you please, you are not restricted to the name OrderBoxCoreExamples , OrderBoxDomainsExamples, OrderBoxHostingExamples, OrderBoxOtherProductsExamples.
Open the IIS management console by navigating to “Start > Programs > Administrative Tools > Internet Information Services”
Now, we need to create an “Application Root” for the examples folder. This can be accomplished by opening the properties window for that directory and clicking on the “Create” button.
If you successfully completed the above steps, you may open your browser and point it to http://localhost/examples (if you gave your examples folder some other name, replace the last word of the URL with that name).
Step 4. Run the examples
Please note first that the ASP.NET examples are provided solely to help illustrate usage of the ASP.NET Kit. You may use the example files directly, or simply use them as a reference project while developing your application to interface with the OrderBox API.
IIS 5.0 and the .NET runtime MUST be installed on your machine, BEFORE you run the kit setup file.
After you’ve installed the ASP.NET examples, open your browser, and point it to “http://localhost/your-examples-folder” (you may use the name given to the examples folder to replace “examples” in the preceding url). This shall open the ASP.NET examples webpage, which is divided into three frames:
The frame on the top allows you to mention the Service URL, your Reseller Username, your Password, ParentID, Language Preference, Role, Debug Mode to make API calls independent of the credentials provided in the APIConstants.vb file. This frame also provides you a checkbox to enable/disable the credentials of this frame. That is, if the checkbox is not selected the APIConstants.vb file credentials will be used to make the API call.
The lower left frame contains a list of links to pages that illustrate the use of each method in the API. When you click a link, it’s corresponding page is displayed in the right hand side frame. You may test the functions by putting in the call parameters in the page.
Step 5. Understanding Errors
Make sure you have read the General API Integration Instructions to obtain links to the error format and possible error documents. Reference: General API Integration Instructions >>
Step 6. Writing your own code
The API classes exist within the namespace OrderBoxCoreLib , OrderBoxDomainsLib, OrderBoxHostingLib, OrderBoxOtherProductsLib. The class named “Properties”, contains static variables useful for debugging, and changing the SOAP End Point.
The following are valid end points for the OrderBox Demo Server:
HTTP DEMO SERVICE URL: “http://api.onlyfordemo.net/anacreon/servlet/APIv3-XML”
HTTPS DEMO SERVICE URL: “https://api.onlyfordemo.net/anacreon/servlet/APIv3-XML”
The following are valid end points for the OrderBox Live Server:
HTTP LIVE SERVICE URL: “http://www.myorderbox.com/anacreon/servlet/APIv3-XML”
HTTPS LIVE SERVICE URL: “https://www.myorderbox.com/anacreon/servlet/APIv3-XML”
Example: To test the examples, you must first create an account on the Demo server. To use the Customer webservices of the OrderBox API, instantiate the customer object as demonstrated below. If at any time the SOAP end point must be changed to some other url, you may simply put the new SOAP end point into this variable.
Properties.Url = “http://soap-end-point”;
The following code instantiates the Customer object. You may now use it’s methods to call various OrderBox API functions. These are SOAP calls, that will be made to the SOAP End Point specified by the Propeties.Url variable.
Customer oCustomer = new Customer ();
To illustrate the use of this object, we shall take the example of a method called getCustomerId. Examine the code snippet below. It uses an object of the Customer class to request the id of a specified username.
|
int result = 0; // First we make sure that our SOAP End Point is pointing to the correct resource. // The examples use a class called Constants, containing static properties that hold your credentials. You may set these properties once, and later in the file simply pass them to the method calls as required. The values set below are simply examples, and must be replaced with your own credentials. // Since we wish to view the soap request and response … // Next we instantiate an object of the Customer class. // We then use this customer object to request the id for a specified username. // Now we display the soap request. // Then we display the soap response. // Lastly we display the result. |
The above code accepts authentication details and a username, and returns an integer value, which is the id corresponding to the username passed. The last parameter of the getCustomerId method is the username for which we requested an id. This id was returned into the integer variable result.
Please note the first five parameters of this method call. They consist of the username, password, role, language preference, and parent id respectively, of the individual calling the method. For the examples, you may make a demo account on the demo server, and pass the username, password, role, language preference and parent id from your demo account to this method call. These are the first five parameters that are passed to every API call that is undertaken. Please make sure that you pass accurate details for these parameters. If you do not, your method call will be unsuccessful.
In registering/managing any domain name on the demo server always use ns1.onlyfordemo.net and ns2.onlyfordemo.net as your nameservers. ANY OTHER Nameserver will result in an INVALID NAMESERVER error.
Step 7. Change the information to Live information when you are ready
When you have got the examples working correctly, you may set the value of Properties.Url to one of the live URL’s, and pass your own authentication details when making API calls.
Tags: 10 Zip, administrator, Administrator Privileges, Api, Api Documentation, Api Guide, Api Kit, ASP.NET, Computer Option, Demo Server, Docs, Explanations, http, installation of IIS, Integration Guide, Internet Information, Internet Information Services, Javadocs, Names, Net Hosting, Option 1, Party Provider, Platforms, Properties, Reference, Setup Application, Step 1, Step 2, Third Party, Two Ways, Visual Studio.Net, www.myorderbox.com/anacreon/servlet/APIv3-XML, Xml, Zip File, Zip Net
How does Gossimer, LLC Sub-Domain Forwarding work?
Using the Sub-domain forwarding service, you can forward any visitor from http://subdomain.your-domain-name.com/ to http://destination-domain-name.com/subdomain/. The Sub-Domain Forwarding service can also be used in conjunction with URL Masking and Path Forwarding services.
For example, if Sub-Domain Forwarding is enabled, then:
http://payments.your-domain-name.com will get successfully forwarded to http://destination-domain-name.com/payments/
http://credit-card.payments.your-domain-name.com will get forwarded to http://destination-domain-name.com/payments/credit-card/
Enabling / Disabling Sub Domain Forwarding
You can enable / disable Sub-Domain Forwarding after you have bought Domain Forwarding for a particular Domain Name. You need to follow the steps mentioned below to activate the same:
Click on the Domain name in the search results to get to the Order Details view.
Upon clicking on Manage Service, selecting the check box enables Sub-Domain Forwarding, while deselecting the same disables this feature.
Tags: Conjunction, Control Panel, Credit Card Payments, Destination Domain Name, Disables, Domain Forwarding, Domain Forwarding Service, Domain Search, Domain Service, Forwarding Services, http, Llc, Manage Service, Path, Search Domain, Sub Domain, Url
The Direct Download Manager is another feature exclusive to the Gossimer Control Panel. It helps you save several hours of your valuable time by allowing you to download files to your web space directly from another server via a HTTP URL or FTP URL.
If you need to transfer large files to your web space that are already available on some other server, then you would typically have to download these files locally to your desktop and re-upload them. All of this could take up quite some time depending on the file size and your Internet connection speed. However, using the server-to-server transfer facility provided by the Direct Download Manager, you can utilize the server’s high speed connection to directly download large files. So, even if you are connected to the Internet via a dial-up connection, file transfers will occur at the very high speeds.
This feature is most useful when you are transferring your Website data from your previous Web Hosting provider, as you could just zip up your whole website and instead of downloading it locally to your desktop, directly download it on the server and unzip it there.
Using the Direct Download Manager
Follow the process mentioned below to download files using the direct download manager:
1. Login to your Control Panel and search for the domain name for which you have purchased this hosting package.
2. In the search results view, click on the domain name. This will take you to the order details view.
3. Click on Manage Web Hosting Service in the lower toolbar.
4. In the Website Management interface pop-up that follows, go to Manage Website -> Additional Tools -> Direct Download Manager.
5. Here, provide the following details
6. Click on Download Now. This would download the file to the location you have specified.
Tags: Additional Tools, Control Panel, Destination Directory, Details View, Dial Up Connection, Direct Download Manager, Domain Name, Download Manager, Downloaded File, File Transfers, High Speed Connection, High Speeds, http, Internet connection speed, Manage Web Hosting Service, Management Interface, Quite Some Time, Server Ftp, Server Transfer, View 3, Web Hosting, Web Hosting Provider, Web Hosting Service, Web Space, Website Management