reseller

is added when reseller has a customer specific business

Change Primary Domain

Description

Changes the primary domain name for an existing Single Domain Linux Hosting Order.

Parameters

Name Data Type Required / Optional
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
order-id Integer Required The OrderId for which the primary domain is to be changed.
new-domain-name String Required The new primary domain name.

HTTP Method

POST

Example Test URL Request

US, Texas Server


https://test.httpapi.com/api/singledomainhosting/linux/us/change-domain-name.json?auth-userid=0&api-key=key&order-id=0&new-domain-name=domain.com


India Server


https://test.httpapi.com/api/singledomainhosting/linux/in/change-domain-name.json?auth-userid=0&api-key=key&order-id=0&new-domain-name=domain.com

Response

Returns a map of the execution details of the change primary domain operation.

Changes to Billing Engine

We have made some changes to how the billing instruments (Invoice, Receipt, Credit Note and Debit Note) work in the system.



Serial Numbering

  • Invoices, Credit Notes, Receipts and Debit Transactions will now have their own Serial numbered ID for each Reseller. The IDs will be called Invoice ID, Credit Note ID, Receipt ID and Debit ID respectively.
  • The Transaction ID will not be added to the Print view and downloaded PDF. However, the Transaction ID will be maintained as a unique map to a transaction throughout the system.
  • The serialised ID will be seen in the Print View and the PDF.
  • In the List Transactions Page, there will be an additional column titled “Billing ID”, where the serialised ID (Invoice ID, Credit Note ID, Receipt ID and Debit ID), for each transaction type will be displayed.
Note

The Serialised Billing IDs will be applicable only to new transactions. The existing transactions in the system will not be updated with a Serialised Billing ID.


Changes to Invoices and introduction of Pending Invoices

  • What is a Pending Invoice?
    • Pending Invoices are those Invoices which have not been paid for, or the Service hasn’t been provided.
    • Pending Invoices do not have an Invoice ID (hence the dashes against them in the Billing ID column). They do however have a Transaction ID, which will show up in the Print view and PDF.

  • What is the difference between a Pending Invoice and an Invoice?
    • A Transaction will be labelled as an Invoice when a full payment has been made, or the Service has been rendered. The latter case would apply if a Reseller chooses to activate the Order without a payment coming in from the Customer. This transaction will be tagged as an Invoice and not a “Pending Invoice”.
    • Invoices will have their own serialised Invoice ID, where as a Pending Invoice will take the Transaction ID.

  • When a full payment does come in for a Pending Invoice or if the Order was activated (whichever comes first):
    • The Pending Invoice will be tagged as an Invoice.
    • This new Invoice will have an Invoice ID.
    • The date on the Invoice will be the date the payment was made or when the Order was activated (whichever came first).



Changes to Credit Notes

  • All Credit Notes need to be associated with an Invoice and will have the associated Invoice ID on them.
  • Credit Notes can only be raised directly from the Invoice and not via the add funds button.
  • Credit Notes will have their own serialised Credit Note ID per Reseller.



Changes to Receipts

  • Receipts will have their own serialised Receipt ID.
  • While adding a Receipt you can choose a sub-type from a dropdown. These sub-types were earlier used for a Credit Notes, but have been moved over to Receipts.



Changes to Debit Notes

  • Debit Notes will be called Debit Transactions.
  • Debit Transactions will have their own serialised Debit ID.
  • In the List Transactions page, Debit Transactions will be listed as Debit.

How do I stop charging GST?

Follow the steps below to stop charging GST to your Customers and Sub-Resellers.

Step 1: Log in to your control panel. Learn how

Step 2: Navigate to the Configure Tax Rules page

In the menu, click on Settings > Finance & Billing> Configure Tax Rules.

Step 3: Disable GST

  • Click on the ON / OFF toggle next to Charge Goods and Service Tax for India to disable GST.


  • Click on the Yes, disable GST button to confirm.

How do I start charging GST?

Follow the steps below to start charging GST to your Customers and Sub-Resellers.

Step 1: Log in to your control panel. Learn how.

Step 2: Navigate to the Configure Tax Rules page

In the menu, click on Settings > Finance & Billing> Configure Tax Rules.

Step 3: Enable GST

  • Click on the ON / OFF toggle next to Charge Goods and Service Tax for India.


  • Enter your GST ID in the provided field and click on Enable GST.

Note
  • GST will be applicable in conjunction with any Tax Rules you have added in your Reseller account. If you have manually added any Tax Rules for charging GST, you should disable them to avoid additionally charging your customers.

  • The GST ID is mandatory only for Resellers based in India.

  • If you have already added your GST ID in your profile, you do not need to add it again while enabling GST.

FAQs

Overview

Goods and Services Tax (GST) is an indirect tax throughout India to replace taxes levied by the Central and State Governments of India.


What are the rules for charging GST?

When the seller is based in India and the buyer (receiving business/end-consumer) is:

  • In the same State: CGST + SGST is to be charged.
  • In another State: IGST is to be charged.
  • In the same Union Territory: CGST + UTGST is to be charged.

When the seller is based outside India and the buyer is:

  • In India and has a valid GST ID: No tax is to be charged.
  • In India but does not have a GST ID: IGST is to be charged
  • Outside India: No tax is to be charged.


Where can I view the Tax Rates applicable?

You can view the Tax Rates from your Control Panel by navigating to Settings > Finance & Billing> Configure Tax Rules and clicking on the View tax rates link under Charge Goods and Service Tax for India



How does this affect me?

  • If you are based in India and you have enabled GST, the invoices generated for customers who are based in India will be updated to include the following:
    • CGST+SGST / IGST / CGST + UTGST as applicable.
    • GST ID of the Seller and Buyer, if available.
    • Service Account Code (SAC)
    • “Original for Recipient” or “Duplicate for Supplier” as applicable.
    • Place of supply.
  • If you are based outside India and you have enabled GST, the invoices generated for customers who are based in India will be updated to include the following:

    • GST tax.
    • GST ID of the Seller and Buyer, if available.
    • Service Account Code (SAC)
    • “Original for Recipient” or “Duplicate for Supplier” as applicable.
    • Place of supply.

    Optionally, if you have provided your GST ID, the invoices generated for customers who are based in India will be updated to include IGST.



How do I add my GST ID?

You can add your GST ID after you start charging GST. Learn how.

You can also add your GST ID from your Control Panel by clicking the icon at the top right corner of the page and then clicking on Your Account & Security. You can then enter your GST ID in the provided field.


Note

The GST ID provided must match the state mentioned in your profile.

Adding / Modifying Authorize.Net Accept Hosted Gateway

Integrating your Authorize.Net Merchant Account with our system will take only few minutes. You do not have to write any code for this but have to simply follow these instructions:

Before you Start

You will need to gather the following details about your Authorize.Net Merchant Account:

  • Your Authorize.Net Merchant API login ID

  • Your Authorize.Net Merchant Transaction Key (available within your Authorize.Net Merchant Account at Settings Link (on the left) -> Security section -> Obtain Transaction Key)

  • The MD5 Hash Value that you have set in the Authorize.Net Merchant Interface (available under How is the MD5 Hash Value Set Up in the Merchant Interface? (Appendix E - The MD5 Hash Security Feature) in the Authorize.Net Implementation Guide.

  • Add the Silent Post URL from your Authorize.net Merchant Account at Tools -> Settings -> Silent Post URL as https://www.foundationapi.com/servlet/AuthorizeNetAuthCompletedServlet

  • Fixed Variable Fee charged per transaction for your account
Note
  • For added security, firstfoot Interactive Pvt Ltd. ensure that your Customers / Sub-Resellers enter their Credit Card Card Verification Value Code (CVV2/CVC2/CID) while transacting online (also known as Card-Not-Present transactions) using the Authorize.Net Payment Gateway. However, Authorize.Net has recently upgraded their systems, due to which now you need to upgrade your Transaction version to 3.1, to support acceptance of Card Verification Value Code.

    You need to follow the instructions listed under Upgrading the Transaction Version (AIM Transaction Response Types) in the Authorize.Net Implementation Guide.

    It is mandatory for you to follow the above instructions before accepting payments from your Customers / Sub-Resellers via the Authorize.Net Payment Gateway through our system.

  • Authorize.Net provides you a couple of security measures by which you can further reduce risk, while accepting funds online:

    • Authorize.Net allows you decline transactions if the Card Verification Value Code (CVV2/CVC2/CID) submitted by your Customers / Sub-Resellers does not match with the Credit Card company's record. To configure this filter to reject certain Card Code responses from the Credit Card company, you need to follow the instructions listed under Credit Card Identification Code (CVV2/CVC2/CID) in the Authorize.Net Implementation Guide.

    • You can also configure the gateway to reject or accept transactions based on the Address Verification System (AVS) code returned. To configure rejection or acceptance of a transaction based on the AVS code, you need to follow the instructions listed under Address Verification System (Appendix C - Features of the Gateway) in the Authorize.Net Implementation Guide.

      The Address Verification System is a system used to verify the identity of the person claiming to own the credit card. The system will check the billing address of the credit card provided by the user with the address on file at the credit card company.

 

Integrating the Authorize.Net Accept Hosted Gateway with your Reseller Account

  1. Login to your Reseller Control Panel. See details

  2. In the Menu, point to Settings -> Finance & Billing -> Payment Gateway and click on List / Add.

  3. Click on the Add a Gateway link.

  4. Click on Authorize.Net Accept Hosted.

  5. Enter the following Authorize.Net Details and save your changes by clicking on the Submit button:

    • Authorize.Net Merchant API login ID: This API ID is provided to you by Authorize.Net.

    • Authorize.Net Merchant Transaction Key: This key is provided to you by Authorize.Net.

    • MD5 Hash Value set at Authorize.Net: The MD5 Hash security feature enables merchants to verify that the results of a transaction were actually send from the gateway. The MD5 Hash value is set from within your Authorize.Net Merchant Interface.

    • 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..

    • Collect Payments in: Select the currency in which you want to charge your Customers credit cards. Your Merchant Account needs to support the currency that is selected.

    • 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 Authorize.Net Currency, before we send your Customer's details to Authorize.Net. For this purpose the system needs an 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 rate.

    • Enable Gateway For: Select appropriate Access Levels for your Customers / Sub-Resellers.

    • Charge Fees for Adding Funds.: Your Bank and Authorize.Net deducts a fee on a per transaction basis. There are two types of Transactions that can pass through your Authorize.Net integration - Invoice/Debit Note Payment and Add Funds.

      In case of an Add Funds transaction, you have the option of passing on the transaction charges to your Customers / Sub-Resellers. 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 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.

    • 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 Authorize.Net 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.

      Note

      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).

    • Approve Pending Transactions: In case you have not yet accepted a payment sent to you via the Authorize.net Payment Gateway, you can get e-mail reminders sent to you daily after x number of days from the payment date, until you either Approve or Decline these payments.

    • Display Position: If you plan on adding multiple Payment Gateways you can select the position in which you wish to display this Gateway on your Payment Page.

Note

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. 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

Check Availability - 3rd level .NAME

Description

Checks the availability of the specified 3rd level .NAME domain name(s).

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
domain-name Array of Strings Required Domain name(s) that you need to check the availability for
tlds String Required Pass *.name for 3rd level .NAME domains

HTTP Method

GET

Example Test URL Request


https://domaincheck.httpapi.com/api/domains/thirdlevelname/available.json?auth-userid=0&api-key=key&domain-name=domain.one&domain-name=domain.two&tlds=*.name

Response

Returns a hash map containing domain name availability status for the requested TLDs:

  • Domain Availability Status (status)

    • available - domain name available for registration

    • regthroughus - domain name currently registered through the Registrar whose connection is being used to check the availability of the domain name

    • regthroughothers - domain name currently registered through a Registrar other than the one whose connection is being used to check the availability of the domain name. If you wish to manage such a domain name through your Reseller / Registrar Account, you may pass a Domain Transfer API call. See details

    • unknown - returned, if for some reason, the Registry connections are not available. You should ideally re-check the domain name availability after some time.

Add

Description

Places a Wordpress Hosting Order for the specified 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 is placed.
customer-id Integer Required The Customer under whom the Order should be added.
plan-id Integer Required The plan under which the Order should be added. To fetch the plan details i.e. plan-id etc., use this method.
noOfMonths Integer Required The number of months for which the Order is placed.
invoice-option String Required This parameter will decide how the Customer Invoices will be handled. Values can be: NoInvoice, PayInvoice, KeepInvoice, OnlyAdd

HTTP Method

POST

Example Test URL Request

https://test.httpapi.com/restapi/product/wordpresshostingusa/order?auth-userid=0&api-key=key&domain-name=domain.com&customer-id=0&plan-id=0&noOfMonths=12&invoice-option=KeepInvoice

Response

Returns a map with the execution details of the Order addition.

FAQs

Overview

Service tax is a tax levied on the transaction of certain services specified by the Government of India.


What are the rules for charging Service Tax?

When the seller is based in India and the buyer (receiving business/end-consumer) is:

  • In India: Service Tax is to be charged.
  • In another country: No Service Tax is to be charged.

When the seller is based outside India and the buyer is:

  • In India and has a valid Service Tax ID: No Service Tax is to be charged.
  • In India but does not have a valid Service Tax ID: Service Tax is to be charged.
  • Outside India: No Service Tax is to be charged.


How does this affect me?

  • If you are based in India and Service Tax is enabled, the invoices generated for customers who are charged Service Tax will be updated to include Service Tax (14%), Swachh Bharat Cess (0.5%) and Krishi Kalyan Cess (0.5%).

  • If you are based outside India and Service Tax is enabled, the invoices generated for customers who are charged Service Tax will be updated to include Service Tax (15%).

    Optionally, if you have provided your Service Tax ID, invoices generated for customers who are charged Service Tax will be updated to include Service Tax (14%), Swachh Bharat Cess (0.5%) and Krishi Kalyan Cess (0.5%).


How do I add my Service Tax ID?

You can add your Service Tax ID after you start charging Service Tax. Learn how.

You can also add your Service Tax ID from your Control Panel by clicking the icon at the top right corner of the page and then clicking on Manage Profile. You can then enter your Service Tax ID in the provided field.