reseller

is added when reseller has a customer specific business

Authorize.net Integration Caveats

Test mode

Test Mode is a special mode of interacting with the system that is useful during the initial setup phase, where a merchant may want to test their setup without processing live card data.

While performing a transaction using the Authorize.net Payment Gateway, you may receive the message - (Testmode) This transaction cannot be accepted.

Please follow the below steps to switch off Test Mode:

  1. Login to the Merchant Interface.

  2. In the main menu, click Settings and Profile.

  3. Click the Test Mode link in the General section.

  4. Now,

    • Click Turn Test ON to place your account in Test Mode, and

    • click Turn Test OFF to turn Test Mode OFF in order to process live transactions.

Note

Transactions that are submitted for capture or void via the Unsettled Transactions menu while your account is in Test Mode are also not actually processed. Please be sure to verify that Test Mode is OFF when you wish to submit real transactions.

About Authorize.Net

Authorize.Net (https://www.authorize.net), a service of Lightbridge, is the preferred global payment-processing service for e-commerce, enabling merchants to process secure transactions in real time, 24 hours a day. Authorize.Net Payment Solutions process credit cards and electronic checks.

has integrated with Authorize.Net API via Advanced Integration Method (AIM), that uses secure sockets layer (SSL) digital certificate technology to connect securely and directly to the Payment Gateway - achieving the highest security for the Internet connection between a merchant and the gateway.

Some of the useful links are listed below:

PayPal Integration Caveats

Note
  • Upon integrating a Paypal payment gateway with your Reseller account, you need to ensure that you spent considerable time in setting up your account, to let your Customer/Sub-Resellers have a pleasing
    experience paying through the PayPal gateway.

  • Do not charge Postage Cost for Products sold through your Reseller account, since
    these products are virtual in nature and do not require to be shipped/posted. Typically, this could happen if you have integrated your PayPal account with another system as well, from where you are selling
    physical goods and need Shipping Cost to be charged.

  • Ensure that you have advised your Customer/Sub-Resellers of the charge that they can expect to see on their Credit Cards, when they pay you through any PayPal Payment Gateway that you
    have configured

Disable Postage Cost

To disable the Shipping Cost:

  1. Login to your Business PayPal account. See details

  2. Click the Profile link under My Account.

  3. Click the Postage Calculations link under Selling Preferences.

  4. Under Cost Method, select the Flat Amount radio button and click the Select button.

  5. Under Cost and Price Ranges, do not enter any Cost for any price range.

    Click the Edit button to save your changes.

  6. Under Miscellaneous, do not select the Click here to allow transaction-based postage values to override the profile postage settings listed above (if profile
    settings are enabled).
    checkbox.

  7. Click the Save button to submit all your changes.

Adding / Modifying a PayPal Standard Checkout Gateway

We provide a secure form-based setup with Paypal, such that integrating a PayPal account with our system will take you only few minutes. You do not have to write any code and simply have to fill in a form specifying your preferences and account details.

When your Customer/Sub-Reseller decides to pay you through this Payment Gateway, our system redirects them to the PayPal website through a secure connection and upon completion of the transaction, they are redirected back to our system.

Before you start

You will need to verify/perform the following before integrating the PayPal Standard Checkout Payment Gateway with your Reseller Account:

  • Verify that you have a Business or Premier PayPal account only. You can not integrate a Personal PayPal account with our System.

  • Using PayPal Standard Checkout Gateway, you would be able to accept funds from only certain countries. See details

  • List of Countries where PayPal supports different types of merchant services. See details

  • Set the Language Encoding in your PayPal account to UTF-8. This can be accomplished as mentioned below:

    1. Click Profile -> Selling Preferences -> Language Encoding -> More Options within your PayPal merchant interface.

    2. Select UTF-8 from the Encoding drop-down menu.

    3. Click Save.

  • Set your PayPal account to block duplicate invoice IDs. This can be accomplished as mentioned below:

    1. Click Profile -> Profile and settings.

    2. Click My selling tools.

    3. Click Update next to Block payments.

    4. Select Yes, block multiple payments per invoice ID under Block accidental payments and click on Save.

  • Turn on IPN notifications from Profile -> My Selling Tools and clicking on Update next to Instant payment notifications. Enter the following URL in the Notification URL field.

    https://foundationapi.com/servlet/PayPalNotifyServlet
Note
  • IPN notifications are not enabled by default.
  • If you do not specify your Language Encoding as UTF-8, then our system would not be able to receive conformation from PayPal's server if a transaction done by your Customer/Sub-Reseller was successful or not and you would have to manually determine the transaction's status.

Adding the PayPal Standard Checkout Gateway in your Reseller Account

  1. Login to your Reseller Control Panel. See details

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

  3. Click the Add a Gateway link.

  4. Click the Add a PayPal Standard Checkout Gateway link.

  5. Enter the following Details and save your changes by clicking 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..

    • PayPal Account Username: Here mention the Primary PayPal Username [E-mail Address] you have set within your PayPal Business or Premier account's Profile.

    • Currency: PayPal allows you to charge your Customers/Sub-Resellers in 22 different Currencies as below:

      • US Dollar (USD)

      • United Kingdom Pound (GBP)

      • Euro (EUR)

      • Canadian Dollar (CAD)

      • Japanese Yen (JPY)

      • Australian Dollar (AUD)

      • Swiss Franc (CHF)

      • Czech Koruna (CZK)

      • Danish Krone (DKK)

      • Hong Kong Dollar (HKD)

      • Hungarian Forint (HUF)

      • Norwegian Kroner (NOK)

      • New Zealand Dollar (NZD)

      • Polish Zloty (PLN)

      • Swedish Krona (SEK)

      • Singapore Dollar (SGD)

      • Mexican Pesos (MXN)

      • Brazilian Real (BRL)

      • Malaysian Ringgits (MYR)

      • Philippine Pesos (PHP)

      • Taiwan New Dollars (TWD)

      • Thai Baht (THB)

      Select the Currency from the drop-down menu.

      Note

      The Currency selected here should match the Currency that you have set within your PayPal account.

    • 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 PayPal Currency before we send your Customer/Sub-Reseller to PayPal. 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. However, if 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.

    • Payment Gateway Access Level for Customers and Sub-Resellers: Select appropriate Access Levels for your Customers / Sub-Resellers.

    • Deciding whether a Sub-Reseller and Customer is Credited with the Gross Amount or Net: PayPal deducts a fee per transaction. There are two types of Transactions that can pass through your PayPal integration - Invoice/Debit Note Payment, and Add Funds.

      In case of an Add Funds Transaction, you have the option of crediting your Customers/Sub-Resellers with the NET Amount that PayPal credits you with or choose to credit them with the gross funds and bear the charges yourselves.

    • Manually Review and Approve any Unverified PayPal Transaction: PayPal has 2 types of Members - Verified and UnVerified. If you wish to manually verify all transactions which originate from Unverified PayPal Members, you would have to select this check box. If this Box is checked, then all PayPal transactions that originate from unverified PayPal members will be kept pending for Review, and you will have to manually approve or cancel them by visiting Customers -> Billing -> Payment Gateway Transactions or Sub-Resellers -> Billing -> Payment Gateway Transactions from your Reseller Control Panel.

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

About PayPal

PayPal (https://www.paypal.com) is an eBay company, offering service to users in several countries. They have over 25 million registered users, including more than 3 million business accounts. PayPal is the most popular online Payment Gateway choice, and is the easiest Payment Gateway to use. It has a free sign-up process and you can be up and running with a PayPal account within no time at all. PayPal accepts members only from a given set of countries, and it is important to note that members outside these countries will not be allowed to transact at all, using PayPal.

PayPal has three types of Accounts - Personal, Premier and Business. You need to have a Premier or Business account in order to be able to integrate your PayPal account with our
system.

You are advised to browse through the PayPal documentation, policies and interfaces in detail before attempting to integrate the same with our System. The specific items you ought to check with PayPal are:

  • Cost of receiving Payments via PayPal

  • Withdrawal Fees and Countries supported

  • Tracking Payments

  • Limits on Sending/Withdrawal/Receiving

  • Chargeback Policy of PayPal

Useful Links

Payment Gateway Risk Assessment Report

has implemented several pioneering fraud detection and prevention mechanisms for some of our Payment Gateway integration modules. This report will help you automatically detect potentially
risky transactions that your Customers/Sub-Resellers have performed. This report is sent to your Billing Team on a daily basis, to allow you to identify any fraudulent transactions from any of the following Payment Gateways:

  • Authorize.Net Credit Card Gateway
  • PayPal (formerly Verisign) Payflow Pro Credit Card Gateway
  • PayPal Direct Payment API Gateway

 

Enabling / Disabling Risk Assessment Report Generation

  1. Login to your Reseller Control Panel. See details

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

  3. You may enable/disable these reports by selecting/deselecting the Turn on the generation of Risk Assessment Reports checkbox in the Global Payment gateway settings section.

    By default, enables generation of Risk Assessment Reports for you and these Reports get daily sent to your Billing Contact Email Address.

    We strongly recommend that you enable this report and manually verify the transactions shown therein, by contacting the corresponding Customer or Sub-Reseller. If you find any of these transactions to be suspicious, you should immediately reverse the credit for them, before your Customers/Sub-Resellers use it. If they have already used the credit you may delete their orders or suspend them or follow any process you may deem necessary.

    We would also recommend you to reverse any suspicious transactions at the Payment Gateway to avoid charge-backs. The Risk Engine assigns a Risk Score to transactions based on a vast accumulated database of information and the history of previous transactions. The Risk Report is divided into sections and special attention should be paid to the High Risk section, if it exists.

    Example of a Payment Gateway Risk Report

    HIGH RISK ALERT LIST - Different Credit Cards used from the Same Machine with Different Card Holder Names

    Username Role Transaction Id Amount Card Holder Name IP Address Status Payment Gateway Name Date {GMT/UTC}
    somebody@domain.com Reseller AddFund-R-87-76 INR567.00 a 192.168.0.82 AuthSuccessful authorize.net 2005-10-25 22:57:49.197707
    test@test.com Reseller AddFund-R-269-75 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-25 22:56:30.059662
    test@test.com Customer AddFund-C-74-74 INR123.00 a 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879
    test@test.com Customer Payment-C-74-22 INR54.21 a 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879
    test@test.com Customer Payment-C-74-23 INR54.21 a 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879

    HIGH RISK ALERT LIST - Different Credit Cards used from the Same IP Address with Different Card Holder Names

    Username Role Transaction Id Amount Card Holder Name IP Address Status Payment Gateway Name Date {GMT/UTC}
    test@test.com Reseller AddFund-R-269-63 INR123.00 test 192.168.0.82 AuthFailed authorize.net 2005-11-07 15:59:42.785879
    test@test.com Reseller AddFund-R-269-64 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879
    somebody@domain.com Customer AddFund-C-74-74 INR123.00 a 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879
    somebody@domain.com Customer Payment-C-74-22 INR54.21 a 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879
    somebody@domain.com Customer Payment-C-74-23 INR54.21 a 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879

    HIGH RISK ALERT LIST - Different Credit Cards used from the Same Email Address with Different Card Holder Names

    Username Role Transaction Id Amount Card Holder Name IP Address Status Payment Gateway Name Date {GMT/UTC}
    test@test.com Reseller AddFund-R-269-65 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-25 19:01:21.878671
    test@test.com Reseller AddFund-R-269-75 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-25 22:56:30.059662
    test@test.com Reseller AddFund-R-269-78 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-26 20:16:43.838572
    test@test.com Reseller AddFund-R-269-79 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-26 20:17:14.089354
    test@test.com Reseller AddFund-R-269-82 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-26 21:00:11.752088
    test@test.com Reseller AddFund-R-269-63 INR123.00 test 192.168.0.82 AuthFailed authorize.net 2005-11-07 15:59:42.785879
    test@test.com Reseller AddFund-R-269-64 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879

    MEDIUM RISK ALERT LIST - Different Credit Cards used from the Same Machine with the Same Card Holder Name

    Username Role Transaction Id Amount Card Holder Name IP Address Status Payment Gateway Name Date {GMT/UTC}
    test@test.com Reseller AddFund-R-269-78 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-26 20:16:43.838572
    test@test.com Reseller AddFund-R-269-79 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-26 20:17:14.089354
    testing@test.com Reseller AddFund-R-269-80 INR123.00 test 192.168.0.82 AuthFailed authorize.net 2005-10-26 20:22:01.244508
    test@test.com Reseller AddFund-R-269-82 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-26 21:00:11.752088
    test@test.com Reseller AddFund-R-269-65 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-10-25 19:01:21.878671
    test@test.com Reseller AddFund-R-269-63 INR123.00 test 192.168.0.82 AuthFailed authorize.net 2005-11-07 15:59:42.785879
    test@test.com Reseller AddFund-R-269-64 INR123.00 test 192.168.0.82 AuthSuccessful authorize.net 2005-11-07 15:59:42.785879

Payment Gateway Transaction types and Access Levels for your Customers and Sub-Resellers

There are two types of Transactions that can be carried out through the Payment Gateway by your Customers and Sub-Resellers:

  • Pay Invoices/Debit Notes: They can directly select a specific Invoice/Debit Note and pay for it using the Payment Gateway.

  • Add Funds: This is where they Add Funds to their Account. These funds can then be utilised by them to pay Invoices/Debit Notes.

Lets understand both these types in further detail:

Pay Invoices/Debit Notes

When a Customer of yours buys a product, an Invoice is created for the same. The Customer can now pay for this Invoice by clicking the Pay button in the Invoice Details view. This
takes him to the Pay Invoice page. Here, he will see a list of payment options, depending on the Payment Gateways you have integrated with your Reseller account. The Customer can
choose to pay for this Invoice using the Payment Gateway of his choice. The same flow exists for a Sub-Reseller of yours.

When the Customer/Sub-Reseller completes the Payment Process for an Invoice/Debit Note, it creates a Receipt of that amount and balances it against the Invoice
that the Customer is paying. The Invoice payment may result in other actions such as execution of the request associated with the Invoice.

Additional Information

Invoices

Add Funds

When a Customer/Sub-Reseller simply want to Add Funds to their account for future use, they can click the My Billing ->
Add Funds menu within their respective Control Panel. This allows them to specify the amount of funds to add to their Account. They can then use these funds
anytime to Pay any Invoice/Debit Note. In an Add Funds operation, the system creates a Receipt for the amount added. The important part to note about an Add
Funds transaction is that the Customer/Sub-Reseller has the freedom to decide the amount to Add to their account.

In both the above cases, the system creates a Receipt. This Receipt amount is also added to the Total Receipts figure for that Customer/Sub-Reseller.

The primary difference between the above two types of transactions is that in the first case the transaction is being performed with the purpose of paying for a particular Invoice/Debit
Note. In the other case, however, the transaction is being performed to add some advance funds to the account which will be utilised later by the Customer/Sub-Reseller.

Payment Gateway Access Levels

The Payment Gateway module has built in security which allows you to choose the types of transactions that you wish to allow for a particular Payment Gateway to your
Customers/Sub-Resellers. During the process of adding any Payment Gateway, you have the following security options for the same -

Payment Gateway Access Level for Customers:

To

Payment Gateway Access Level for
Sub-Resellers:

To

As you can see, you have the ability to specify separate Access Levels for your Customers and Sub-Resellers. The first row specifies the access level to the Gateway for your Customers,
and the second row specifies the access level to the Gateway for your Sub-Resellers. Both the rows contain the exact same options and are mutually exclusive. The settings of the first row
do not affect the settings of the second row. You can specify completely different settings for your Customers using your Payment Gateway as opposed to your Resellers using your
Payment Gateway.

The Access level specifier consists of two dropdown menus.

The first dropdown refers to the types of transactions that you wish to allow through this Gateway. This has the following four options:

  • Do not Allow ANY Transactions: This option signifies exactly what it states. If you choose this option for your Customers, the Payment Gateway is as good as disabled
    for your Customers. Your Customers will not be able to transact using this particular Payment Gateway. You may wish to do this incase you add a Payment Gateway that you only
    want your Sub-Resellers to use (or vice-versa). You can also do this temporarily incase your Payment Gateway is down, or you are performing some tests. Then during this time,
    while the dropdown is set to Do Not Allow ANY Transactions, the option to pay through this gateway will not appear for your Customers/Sub-Resellers.

    Note

    If in the first dropdown menu you have selected Do not Allow ANY Transactions, it does not then matter what you select in second dropdown menu of the row and
    therefore it is disabled.

  • Allow ALL Transactions: This is the exact opposite of Do not Allow ANY Transactions. This tells the system that you wish to allow ALL types of
    transactions.

  • Allow only Add Funds: This will display the Gateway as a payment option only for Add Funds transactions.

  • Allow only Invoice/Debit Note Payments: This will display the Gateway as a payment option only for Invoice/Debit Note Payment transactions.

  • The second dropdown menu refers to the category of Customers/Sub-Resellers that you wish to allow the transactions to. The second dropdown is dependant on the first one. It further
    refines the security by allowing you to restrict access of the Gateway to a given set of Customers/Sub-Resellers. This dropdown has the following three options:

    • Allow All: This setting would allow the types of transactions that you have chosen in the first dropdown menu, to ALL Customers/Sub-Resellers.

    • Allow Explicitly Authorised Customers or Sub-Resellers: This setting would allow you to specify a set of your Sub-Resellers or Customers. The System would then
      only allow these Customers/Sub-Resellers to use this Payment Gateway. This is explained in further detail a little ahead.

    • Allow Customers or Sub-Resellers of Explicitly Authorised Countries: This setting would allow you to specify a set of countries, whose Customers and Sub-Resellers
      you want to restrict from seeing a Payment Gateway. This is explained in further detail a little ahead.

    As you can see, creative combinations of the dropdown above can allow you to decide who gets to use your Payment Gateway v/s who does not. Lets take a few examples -

    Example 1

    Payment Gateway Access Level for Customers:

    To

    Payment Gateway Access Level for
    Sub-Resellers:

    To

    The above setting for a particular Payment Gateway means

    • None of your Customers can use this Payment Gateway. Note that since the first dropdown menu says Do not Allow ANY Transactions, it does not matter what
      you select in the second dropdown menu for Customers.

    • All your Sub-Resellers will see this Payment Gateway as a payment option when they either choose to pay for an Invoice/Debit Note or choose to Add Funds.

    Example 2

    Payment Gateway Access Level for Customers:

    To

    Payment Gateway Access Level for
    Sub-Resellers:

    To

    The above setting for a particular Payment Gateway means

    • All of your Customers will see this Payment Gateway as a payment option when they choose to pay for an Invoice/Debit Note.

    • Only those Sub-Resellers whom you have explicitly authorized will see this Payment Gateway as a payment option when they choose to Add Funds to their account.

    Example 3

    Payment Gateway Access Level for Customers:

    To

    Payment Gateway Access Level for
    Sub-Resellers:

    To

    The above setting for a particular Payment Gateway means

    • All of your Customers of the specified countries will see this Payment Gateway as a payment option when they choose to pay for both types of transactions - Add Funds and
      Invoice/Debit Note Payments.

    • Only those Sub-Resellers whom you have explicitly authorized will see this Payment Gateway as a payment option when they choose to Add Funds to their account.

    Explicitly Authorising Sub-Resellers/Customers

    If you have set the access level for a Payment Gateway to Explicitly Authorised Customers / Sub-Resellers, then in the toolbar of the Details view of that Payment
    Gateway, you will now see a new Manage PG Access for button as follows -

    Custom Payment Settings




    |

    |


    You can use this option to specify the set of Sub-Resellers (or Customers) which you wish to authorize to use this Payment Gateway. The set of Sub-Resellers (or Customers) which
    you specify in this section will be the only ones which get to see this Payment Gateway on your Payment options page for the types of transactions which you have enabled.

    Authorising all Sub-Resellers/Customers of Explicitly Authorised Countries

    If you have set the access level for a Payment Gateway to All Customers / Sub-Resellers of Explicitly Authorised Countries, then in the toolbar of the Details view of
    that Payment Gateway, you will now see a new Manage PG Access for button as follows -

    Custom Payment Settings




    |

    |


    You can use this option to specify the set of Countries whose Customers (or Sub-Resellers) you want to display a particular Payment Gateway. Depending on the set of Countries
    you
    authorize, Customers (or Sub-Resellers) belonging to those Countries would be the only ones which get to see this Payment Gateway on your Payment options page for the types of
    transactions which you have enabled.

    Note
    • Upon setting the Explicitly Authorised Countries restriction, the system will check the Customer/Reseller's country based on their IP Address at the time of
      transacting.

      Example:

      If you have blocked the Country Nigeria for your Customers, a Customer will be unable to pay if as per his IP Address his Country is Nigeria, even if his Customer
      Profile
      displays the Country as USA.

    • 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