H-Sphere Documentation Administrator Guide Merchant Gateway Manager


SecureTrading Configuration

(version 2.4 and higher)


Related Docs:   Merchant Gateway Manager Supported Merchant Gateway Providers



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 Supported Merchant Gateway Providers

User comments
No comments for this page.
Sorry, adding new comments is temporary unavailable

Home   Products   Services   Partners   Support   News   Contact   Forum
© Copyright 1998-2006. Positive Software Corporation.
All rights reserved.