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.



Download 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
  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 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 script to start XPay client.

For more information about XPay client configuration see Readme.txt in the 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

© Copyright 2018. Parallels Holdings. All rights reserved.