Parallels H-Sphere Documentation Administrator Guide Merchant Gateway Manager

 

SecureTrading Configuration

 
 

Related Docs:   Merchant Gateway Manager Supported Merchant Gateway Providers

Last modified: 26 Dec 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

 

Preparation

Download xpay.zip from SecureTrading and place its content into /hsphere/local/home/cpanel/XPay directory on your control panel server:

  1. Log into your control panel server and go to XPay directory:
    su -
    cd /hsphere/local/home/cpanel/XPay
  2. Unpack xpay.zip:
    unzip xpay.zip
  3. Copy XPay.jar file into /hsphere/local/home/cpanel/java_rt directory:
    cp XPay.jar /hsphere/local/home/cpanel/java_rt
  4. Create the keystore file for XPay client:
    keytool -import -file securetradingxpay.cer -alias xpay -keystore xpay
  5. Edit the examplepolicy file and set the correct path to your keystore file, e.g:
    keystore file: /hsphere/local/home/cpanel/XPay/xpay
  6. Go to the startup directory and edit the xpay.sh file. Modify the variables: XPAYPOLICY, CLASSPATH and JAVAPATH. See configuration options:
    1. Set the location of the policy file
      XPAYPOLICY=/hsphere/local/home/cpanel/XPay/examplepolicy
    2. Set the location of the XPay jar file:
      CLASSPATH=/hsphere/local/home/cpanel/java_rt/XPay.jar
    3. Set path to java executable:
      JAVAPATH=/usr/java/jdk1.3.1/bin
  7. Run the xpay.sh script to start XPay client.

For more information about XPay client configuration see Readme.txt in the xpay.zip bundle.

 

Configuration

  1. Select SecureTrading in the Add New Gateway box.
  2. Click the Add button.
  3. Fill out the form that appears:

    • Title: give a name to this SecureTrading connection
    • Currency: the currency in which your end users will be charged
    • Site Reference: enter valid site reference sent to you by SecureTrading upon registration
    • Notification Email for VOID and CAPTURE Transactions: SecureTrading doesn't support VOID and CAPTURE transactions. Instead, H-Sphere sends a notification to this address that the transaction needs to be canceled or completed manually through SecureTrading web interface.
  4. Click Submit Query
  5. In the Edit Gateway box choose Secure Trading from the drop-down box.
  6. Click the Edit button.
    The page that appears shows the Path and name for certificate file. You need to place the certificate which you received from Secure Trading under that name on the Control Panel server.
  7. Click Submit Query.

Related Docs:   Merchant Gateway Manager Supported Merchant Gateway Providers



© Copyright 2017. Parallels Holdings. All rights reserved.