H-Sphere Documentation Sysadmin Guide

For more information contact us at info@h-sphere.co.uk

Merchant Gateway Configuration

 

This document explains how to install and configure supported merchant gateways.

 

For most merchant gateways, use the following procedure:

  1. Get registered with the Online Processing Center and obtain the required lib file.
  2. Put the lib file into in the directory ~cpanel/java.rt/.
  3. Specify the location of this file in .bash_profile of the cpanel user (CLASSPATH string);
    Edit /hsphere/local/home/cpanel/apache/etc/jserv.properties to include the following string:
    wrapper.classpath=/hsphere/local/home/cpanel/java_rt/NAME.jar, where NAME is the name of the lib file.
  4. Restart Control Panel.

The peculiarities or differences between merchant gateways are specified in the table below:

Gateway

Required Libs

Peculiarities

AuthorizeNet

-

Ready for use immediately after the installation of H-Sphere

VeriSign Payflow Pro

Verisign.jar
(part of pfpro_java.tar.gz)

Standard procedure

VeriSign Payflow Pro (with SSL support)

Verisign.jar
(part of pfpro_java.tar.gz)

pfpro_java.tar.gz contains a file with SSL certificate from VeriSign Payflow Pro.
Put it somewhere in your system, e.g: ~cpanel/shiva/psoft.config/certs/.
Then go to your main admin CP->Settings->MerchantGateway and in the Payflow Pro (with SSL support) account settings enter the path to this SSL file.

Paradata

trans_client.jar

Standard procedure. Include trans_client.jar after rt.jar, but before jce1_2_1.jar (java cryptography extension).

Bibit
(v. 2.09 and higher)

-

Ready for use immediately after the installation of H-Sphere.

PayAndShop

payandshop.jar

Standard procedure

ePDQ

CcxClientApi.jar

Standard procedure

LinkPoint

liblpapi.a

1. go to directory /hsphere/shared/scripts/LinkPoint
2. unpack api.tar.gz
3. copy liblpapi.a to /usr/lib/
4. execute make
5. execute make install
Also, you need to get a user certificate from LinkPoint and put it to a separate file. You will have to specify the path to this file in the control panel.

CyberCash

mck-3.3.1-i586-pc-linux-gnulibc2.1

see below

PSiGate (v. 2.1 and higher)

ccc_ssl.jar

Once PSiGate is set up, H-Sphere will generate names for *.der files to be put into the /hpshere/home/cpanel/shiva/psoft_config/psigate directory. Certificate and key are given by PSiGate after the agreement is made. You should get them from your gateway and store them using the filenames generated by H-Sphere.

PayReady (v.2.11 and higher)

-

Ready for use immediately after the installation of H-Sphere

 

Installing CyberCash

  1. Get registered
  2. Download file mck-3.3.1-i586-pc-linux-gnulibc2.1.
  3. Make this file executable.
  4. Run install, choose YES I ACCEPT.
  5. Set up Shared-Server installation (./configure --asp)
  6. When prompted, choose Perl as the language that you want to allow your merchants to use:
    What type of CGI scripts would you like to support? (P/C/B) [Perl]:

    • Perl - Requires Perl version 5.005 or higher;
    • C - Requires an ANSI compatible C compiler;
    • Both - Requires both of the abovementioned language compilers.
  7. Specify the location for the build-merchant script.
    As an ASP, you have the options of either allowing your merchants to install their own MCK or building it for them yourself. If you wish to allow merchants to install their own MCK, the build-merchant script needs to be copied to a directory that is in the execution path of all users. This script will give merchants the ability to setup their own configurations, and optionally install the customized configurations to their WEB server directories.

    Do you wish to copy the build-merchant script to a public location? (y/n) [n]:

  8. The Merchant Connection Kit Perl scripts refer to libraries and utilities to perform common functions. These files must be installed to a directory that is accessible to the MCK CGI scripts.

    NOTE: This directory should be a permanent location for these files. If removed or relocated at a later time, any existing merchant CGI's will no longer work.

    Where do you want to install the Perl utilities?
    [/home/install/mck-3.3.1-i586-pc-linux-gnulibc2.1/perl-api]:
    > /hsphere/shared/lib/cybercash
    Directory /hsphere/shared/lib/cybercash does not exist, create it? (y/n) [n]: y
    Modifying Shared-Server utilities ...
    Installing Perl libraries and utilities.
    ASP Shared-Server Configuration complete.
    		  
    You can now customize any templates or scripts in the 'master-merchant' directory. These files will be used as a basis for building new MCK installations for your merchants.
  9. Change path to CyberCash libs in CyberCashWrapper.pl.


Home   Products   Services   Partners   Support   News   Contact   Forum
© Altaire Limited.
All rights reserved.