H-Sphere Documentation Administrator Guide


Merchant Gateway Manager


Related Docs:   Adding Merchant Gateways (Developer guide) Supported Merchant Gateway Providers CVV Credit Card Verification


Configuring Specific Gateways:

    AuthorizeNet (ADC Relay)
    AuthorizeNet (SIM Protocol)
    LinkPoint (API v.3.01)
    Main Street Softworks
    Plug'n Pay
    Protx (VSP Direct Protocol v.2.20)
    Secure Trading
    VeriSign Payflow Pro
    VeriSign Payflow Pro with SSL Support




Positive Software recommends
Processing Credit Cards Payment Solutions:

Merchant Gateway Manager is a configurable H-Sphere add-on that allows you to set up and alter merchant gateways, the media for conducting transactions with online credit card processing centers. The software tracks gateway usage and provides statistical information on the number of transactions and total charges for every particular gateway.

Merchant Gateway Manager allows you to setup different merchant gateway accounts for different types of credit cards (like VISA, MasterCard, Discover, American Express). In this way you can maximize your profits by processing every type of credit card with the gateway that offers the lowest rate for this type of card.

Before configuring a merchant gateway, register an account with a supported merchant gateway.

Resellers can't use admin merchant gateway settings. They should register their own accounts with chosen Merchant Gateways.

This document explains how to:


Setting Up Merchant Gateways

Once you have registered an account with a credit card processing center, you can set up a merchant gateway to your H-Sphere configuration:

  1. Select Merchant Gateway in the Settings menu:

  2. The following page will appear:

  3. If you need to test H-Sphere billing without making real charges, select Dummy Gateway in the Add new gateway box and use it in the subsequent configuration steps. To configure real gateways, see the box Configuring Specific Gateways on the right for links to instructions.


Editing Merchant Gateway Settings

If you need to edit the configuration of the merchant gateway, do the following:

  • In the Edit Gateway box choose necessary merchant gateway from the drop-down box.
  • Click the Edit button. On the form that appears you can make necessary changes.
  • Click the Submit Query button to save changes.


Associating Merchant Gateways with Credit Card Vendors

Now that you have configured one or more merchant gateways, you need to associate them with credit card vendors. You can have different credit card brands processed with different processing centers. For example, you can configure H-Sphere to process VISA and MASTERCARD with AuthorizeNet, and AMERICAN EXPRESS - with CyberCash. To set the associations:

  1. In the Set Active field, choose the credit card brand and the processing center it will be charged through.
  2. Click the Activate button to create the association. Now your Merchant Gateway Manager form should look similar to this:

  3. Make sure to create associations for each credit card brand you would like to support. Users won't be able to pay with the credit cards that haven't been associated with any processing center.

Editing description for User credit card statements.

(version 2.2 and higher)

Use this feature to let your customers know from their credit card statements what charges are related to hosting with H-Sphere.

  1. Select Merchant Gateway in the Settings menu.
  2. Enter the description text in the Edit Description text box.
  3. Click Submit Query.


Handling CC charge request failures

(version 2.3 and higher)

H-Sphere suggests a solution to handle rejected credit card transactions by setting the maximum failed charge attempts and the retry interval. If a processing center rejects a CC charge request, H-Sphere will:
1. debit the account;
2. notify the user by e-mail at the address provided in the user contact/billing info;
3. send this CC request again in the defined period of time (see below);
4. disable any other paid operations with this CC until this period elapses.
With the first successful credit card transaction, the charge failure counter is reset.

To configure this behavior:

  1. Select Merchant Gateway in the Settings menu.
  2. Fill out the last two fields on the Merchant Gateway Manager page:

  3. - Maximum allowed failed charge attempts for credit cards: restrict the number of CC charge request failures.
    - Retry interval after failed attempt to process CC (min): set the period (in minutes) to elapse before the system resends the charge request. Until then, the system will disable any transactions with this CC.

If charge failures reach the maximum number allowed, H-Sphere will mark such credit card as nonchargeable until you reset the charge failure counter:

  1. Select CC processing errors in the Reports menu;
  2. Retrieve the needed account;
  3. In the Controls column of the Search Results page, click the Reset icon for this account.


One Step Gateways

To offer completely automated credit card processing, a merchant gateway must support the following 4 types of transactions:

  • VOID

Most credit card charges involve only the CHARGE transaction. An exception is domain registration, which involves two steps:

1. Lock required amount on the credit card (AUTHORIZE) before domain registration
2.a. If domain registration succeeds, debit the locked amount to the credit card (CAPTURE)
2.b. If domain registration fails, unlock the amount and cancel the initiated transaction (VOID)

Some merchant gateways don't support CAPTURE or VOID transactions, requiring that they be performed manually through a web interface. In case of domain registration, you will receive email notifications requesting to complete or cancel a transaction every time a user registers a domain name.

Related Docs:   Adding Merchant Gateways (Developer guide) Supported Merchant Gateway Providers CVV Credit Card Verification

User comments
No comments for this page.
Add comment

Home   Products   Services   Partners   Support   News   Contact   Forum
© 2020 psoft.net
All rights reserved.