is added when reseller has a customer specific business

Payment Gateway Integration Guide

You can integrate ANY Payment Gateway of your choice with your SuperSite. We provide a customized integration process which allows you to accept payments from your Customers and Sub-Resellers using any Payment Gateway of your choice. Our module seamlessly integrates with the Payment Gateway. Additionally the specifications allow you to develop the integration in your own language too. The customized Payment Gateway Integration would require you to perform very little coding.

Over and above the customized module which works with ANY Payment Gateway, we also offer a specialized integration module for PayPal users, which does not require any coding.

What are Locked Funds?

The concept of Locked Funds is really simple. Every Order that is processed deducts funds from your Account. However, most Orders typically take some time to get processed. The process of executing an Order consists of several steps. There is a chance that the steps may fail and the Order does not get processed. Therefore, we deduct funds from your account only at the last step after the Processing is complete, and the Order has been successfully executed.

However, in order to prevent the possibility of your account not having funds at that time, when the Order is processed successfully, we lock the amount of funds required for a particular Order, while it is processing. As soon as the Order Processing steps are complete the Locked Funds are either deducted from your account or the lock is removed depending on whether the execution of the particular requested action was successful or not.

There are also times when the process of executing a particular action of an Order takes several days. Some requests may take 5-10 days to get processed, like domain name Transfers. We would in this case lock funds required for a
successful completion of the request at the beginning of the request, as soon as it is executed. Once the Order is executed, Successfully we would deduct these funds from your account. If the Order fails we would credit the Locked Funds
back to your account.

For example, if there is an Order executing in your account which is likely to take 5-10 days, and your purchase price for the Order is USD 10, we would then lock USD 10 out of your available balance and begin processing this Order. If
the Order is processed successfully, we would deduct this USD 10 from your balance. If the Order fails, we would simply remove the lock on the USD 10.

Basically this means that when you pay us for an Order, we do not utilize those funds immediately. We lock the funds and begin processing the Order. If the processing fails, then we release the lock and the funds are again available in
your Account for you to use against anything else.

You can check out the complete list of Locked Funds for all your Orders which are currently in processing by clicking My Billing -> Locked Funds within your Reseller Control Panel. This list shows you the Orders for which funds have been locked from your account, and the quantum of funds locked for that Order.

Requesting a Refund

You may easily withdraw excess funds from your Debit Account with by requesting for a refund. You may only withdraw funds from
your available Debit Account Balance.


The funds that are actually refunded may not be equal to the funds you requested due to one or more of the following factors:

  • our refund policy,

  • foreign exchange conversion fluctuations,

  • bank charges, which may be deducted by our bank and/or yours.

To Request a Refund

  1. Login to your Reseller Control Panel. See details

  2. In the Menu, point to My Billing and click Withdraw Funds.

  3. Here you will be displayed Your Total Balance, Locked Amount and Withdrawable Balance. Enter the Amount to Withdraw.

  4. In the Withdrawal Description field, mention how you want to receive your refund amount.


    • Refund to my Credit Card

    • Refund to my PayPal Account:

    • Refund as Wire Transfer to Bank Account no.: XXX-XXX

    • Refund via cheque to my postal address: XXX

  5. Click the Place Withdrawal Request button to send a Withdrawal Request to our Billing Team.

Balancing a Pending Invoice or Debit Note

If has raised an Invoice or Debit Note for you, you would have to pay for it in order to settle it.

To Pay for a Pending Invoice or Debit Note

  1. Login to your Reseller Control Panel. See details

  2. In the Menu, point to My Billing and click Pending Payments.

  3. From this list, select the ones that you wish to execute / pay.

  4. Click the Pay button.

  5. Here your Debit Account Balance will be displayed. Now, you have 2 options:

    • If sufficient funds are available, you can click the Continue button to balance the Invoice/Debit Note.

    • If you do not have sufficient funds in your account, you can click the Add Funds button, where you would be presented with various methods available to add funds to your account.
      Once the Funds have been added to your Account, you would have to pay for the Invoice by following instructions from step 2 above.

Adding Funds in your Debit Account

You can view the various methods of Adding Funds to your Account from within your Reseller Control Panel. You need to follow the steps mentioned below:

  1. Login to your Control Panel. See details

  2. In the Menu, point to My Billing and click Add Funds.

  3. You would be presented with various methods available to Add Funds to your Account with . You can choose one of the options and Add Funds to your Account.


Adding Funds to your account does not automatically settle any Invoice/Debit Note pending against your Account. You will have to manually settle it.

Configuring a Tax Rule to collect Indirect Tax from your Customers and Sub-Resellers

Once you have understood what Indirect Tax is and how our Tax Engine can be used to collect the same from your Customers and Sub-Resellers, you can proceed adding a
Tax Rule for any Products/Services to which Tax is applicable:

To Configure a Tax Rule

  1. Login to your Control Panel. See details

  2. In the Menu, point to Settings -> Finance & Billing and click Configure Tax Rules.

  3. Review any existing Tax Rule that you may have created before and then click the Add New Tax Rule button to create a unique Tax Rule.

  4. Fill in the following details and click the Proceed button:

    • Product Category: For each Product that you wish to tax your Customers/Sub-Resellers, you need to create a separate Tax Rule. In case you
      wish to charge the same Tax for all Products, you would need to repeat these steps.

    • Percentage: This is amount in percentage that you wish to be charged over the Invoice amount to your Customers/Sub-Resellers.

    • Tax Label: This is the name of the Tax that will be shown to your Customers/Sub-Resellers in their Invoices.


      • Sales Tax

      • VAT

      • Service Tax

    • Country: Select the Country here for which this Tax Rule needs to be applied. Select Any Country to apply this Rule to all
      Customers/Sub-Resellers irrespective of their Country.

    • State: Select the State from the selected Country here. Select Any State to apply this Rule to all Customers/Sub-Resellers
      irrespective of their State.

    • Time Zone: The Time Zone works in conjunction with your Tax Rule's Start and End Date. That is, a particular Tax Rule starts and end as per
      the Time Zone you have selected.

    • Tax Start Date: This indicates the day when a particular Tax Rule would start from. Any Invoice prior to the Start Date would not be Taxable.
      You may set the Start Date as either today or any day after that.

    • Tax End Date: This indicates the day when a particular Tax Rule would end. Any Invoice after the End Date would not be Taxed.
      You may set the End Date as same as the Start Date or any day after that.

    • Invoice Footer: Here you should mention your Tax Registration Number or any other detail regarding this particular Tax Label,
      to be displayed within Invoices to your Customers/Sub-Resellers to whom this Tax applies.


      The Invoice Footer is only displayed to your Customer/Sub-Reseller when he clicks the Print button in the Invoice Details view.

    • Exempted Reseller Ids: Here you may mention any Reseller Ids to whom you do not want this Tax to be applied. Typically, you may want to
      do this for any Sub-Reseller account that you may have created for yourself.

    • Exempted Customer Ids: Here you may mention any Customer Ids to whom you do not want this Tax to be applied. Typically, you may want to
      do this for any Customer account that you may have created for yourself.

  5. Confirm that you have set the Tax Rule appropriately and then click the Confirm button. If you wish to tweak the Rule further, you may click the Modify button and
    then proceed further. Clicking the Cancel button will abort this Rule's creation.

    Upon confirming a particular Tax Rule, Tax would begin displaying to your Customers/Sub-Resellers for the selected Product from the Start Date.

Effect of a Tax Rule on Transactions

Effect of a Tax Rule while Adding an Invoice

  • Each time an Invoice is raised, the system will check if there is a matching active Tax Rule. If there is a matching Tax Rule, then the Tax amount is calculated and stored alongwith the Invoice

  • The Invoice payable by your Customers/Sub-Resellers would be inclusive of the Tax amount.

Effect of a Tax Rule while Balancing/Paying an Invoice

Additional Information

Balance/Pay a Pending Invoice

  • When an Invoice is to be balanced against a Credit Note/Receipt, then the entire Invoice amount including the Tax amount needs to be balanced/paid.

  • In case any Invoice is partially balanced/paid then the Tax amount can be considered to be balanced/paid proportionately.

Understanding Taxes and how the firstfoot Interactive Pvt Ltd. Tax Engine works

A tax is a financial levy or charge imposed by the local, state or federal government of the taxpayer. There are two types of tax:

  1. Direct Tax: which are paid directly to the government by the taxpayer such as Income Tax, Corporate Tax, etc..

  2. Indirect Tax: which is paid through one or more intermediaries to the government. Examples of Indirect Tax include Sales Tax, Value Added Tax (VAT), Service Tax, etc..

The Tax Engine module allows you to collect any Indirect Taxes from your Customers and Sub-Resellers, when you sell any product or service to them using our system.

Understanding How the Tax Engine Works

  1. The Tax Engine can handle only Variable taxes as a percentage of the Invoice Amount. Any Fixed amount Tax needs to be raised as a Miscellaneous Invoice separately.

  2. Tax is stored against only Invoices.


    Tax is calculated on the amount of the Invoice.


    If say you have configured 10% Tax on Domain Registration, then when an Order for a 10 year Registration term of USD 5 per year is added, then 10% Tax is calculated on the Invoice amount of USD 50 (USD 5 x 10 years). So the Tax amount will be 10% of USD 50 ie. USD 5. The Invoice raised would be of USD 55 and would display the following upon clicking the same:

    Invoice Subtotal: USD 50
    Tax: USD 5
    Invoice Amount: USD 55

  3. A Tax Rule consists of

    • Name of the Tax (eg. Sales Tax, VAT, etc.)

    • Product Category for which the tax is applicable

    • Country and State combination to which the rule applies

    • Percentage of the Invoice amount for calculating the tax

    • Any information that you wish to display to your Sub-Resellers and Customers when an Invoice is generated under this tax rule

    • Start and End Date of this Tax Rule alongwith the applicable Time Zone

    • Exempted Sub-Reseller and Customer Ids

  4. The system does not allow you to create conflicting tax rules and separate tax rules need to be created for each Product/Service that you are selling for each unique State and Country combination within a set timeframe. This means that if you are selling 2 products A and B, then you may create rules such as -

    Product Category Percentage of Invoice Amount Name of Tax Country State Time Zone Begin Date End Date
    A 10 Sales Tax Any Country Any State GMT 10-08-2006 10-10-2006
    A 15 Service Tax Any Country Any State GMT 11-10-2006 10-08-2007
    B 6.3 Sales Tax USA Arizona MST 10-08-2006 10-08-2007
    B 5 VAT China Beijing Beijing 10-08-2006 10-08-2007

    Let's analyze the above example,

    • For Product A two Tax Rules have been created which are applicable to all Countries. This is only possible since they do not have overlapping timeframes ie. the second tax rule is starting after the first tax rule has ended.

    • If more than 1 tax needs to be applied for a particular Product for a unique Country & State combination, then you would need to add all tax percentages and mention the same in a single Tax Rule under an appropriately named Tax, so that your Sub-Resellers and Customers can identify which tax they are paying.

  5. If you modify an existing tax rule for a Product/Service, then the system deactivates the previous tax rule and creates a fresh one for the same, with the modifications submitted.

    This implies that if say you modify the Percentage of Invoice Amount of an existing rule, it would not modify the same in the previously generated Invoices, and would only affect Invoices generated after this modification has completed. The same is applicable for any other Tax Rule parameter such as Invoice Footer.