H-Sphere Reseller Guide

SecureTrading Configuration

(version 2.4 and higher)


Related Docs:  

Merchant Gateway Manager



Contact your hosting service provider to work with files on the host server.

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
    2. Set the location of the XPay jar file:
    3. Set path to java executable:
  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.



  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

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