H-Sphere Reseller Guide

Merchant Gateway Manager

 

Related Docs:  

CVV Credit Card Verification

     

Configuring Specific Gateways:

    AssureBuy
    AuthorizeNet (ADC Relay)
    AuthorizeNet (SIM Protocol)
    Bibit
    Cardia Services
    CyberCash
    Echo
    Ematic
    ePDQ
    eWay
    InnovativeGateway
    InterCept
    IonGate
    LinkPoint (API v.3.01)
    Main Street Softworks
    Moneris
    NetBilling
    NTPNow
    Paradata
    PayAndShop
    PayGate
    PayJunction
    Pay-Me-Now
    PayReady
    Plug'n Pay
    PosNet
    Protx (VSP Direct Protocol v.2.20)
    PSiGate
    SecurePay
    SecurePay.com.au
    Secure Trading
    SkipJack
    ThePayDesk
    Tucows
    VeriSign Payflow Pro
    VeriSign Payflow Pro with SSL Support     Paypal

     

 

 

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.

IMPORTANT!
Starting with version 2.4, new merchant gateways are integrated to H-Sphere by means of packages. You can:
- download merchant gateway packages compiled by Positive Software
- build your own packages using Merchant Gateway SDK.

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 handles 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 administrator by e-mail (end user isn't notified);
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:

  • AUTHORIZE
  • CHARGE
  • CAPTURE
  • 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:  

CVV Credit Card Verification



© Copyright 1998-2006. Positive Software Corporation.
All rights reserved.