Parallels H-Sphere Documentation Reseller Guide Merchant Gateway Manager


PSiGate Configuration

(for accounts created before HS 2.5 Patch 7)

Related Docs:   Merchant Gateway Manager Supported Merchant Gateway Providers PsiGate (XML API)

Last modified: 21 Nov 2006


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.



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

Make sure that the ccc_ssl.jar file is present in the /hsphere/local/home/cpanel/java_rt/ directory.

If it's not there:

  1. Contact PSiGate and obtain the ccc_ssl.jar file.
  2. Put the lib file into in the directory ~cpanel/java_rt/.
  3. Restart H-Sphere.



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

    • Title: give a name to this PSiGate connection
    • Server: the name of the PSiGate server
    • Port: the port of the PSiGate server
    • E-mail: the email address you provided on signing up with PSiGate
    • Store Name: Your PSiGate unique ID, sometimes also referred to as Config File
    • Key File: the filename and location on the server relative to /hsphere/local/home/cpanel/shiva/ where you must put the *.der key file
    • Certificate File: the filename and location on the control panel server relative to /hsphere/local/home/cpanel/shiva/ where you must put the *.der certificate file
    • Test Mode:
      - FALSE: credit card transactions will be completed and credit cards will be charged;
      - TRUE: authorization requests will be sent for verification without settlement requests and credit cards won't be charged.
      * In Test Mode, all transactions appear to be processed as real transactions. The gateway accepts the transactions, but does not pass them on to the financial institutions. Accordingly, all transactions will be approved by the gateway when Test Mode is turned on.
  4. Click Submit Query
  5. In Edit Gateway, select the newly created connection and press Edit.
  6. Note the two new parameters that appeared on the gateway configuration page, Key File, and Certificate File. Put the key and certificate files on the control panel server to the locations suggested here.

Make sure PSiGate provides you with a certificate. If you received key and certificate files in the .pem format, you must convert them into the .der format. To do it:

  1. Log into the CP server as the cpanel user.
  2. Go to /hsphere/local/home/cpanel/shiva/psoft_config/psigate directory. If this directory doesn't exist, create it:
    mkdir psigate
    chown cpanel:cpanel psigate
    chmod 700 psigate
  3. Run the following utilities substituting 'your_file' with your own:
  4. for certificate: openssl x509 -inform PEM -outform DER -in your_file.pem -out your_file.der
    for key: openssl rsa -inform PEM -outform DER -in your_file.pem -out your_file.der

Related Docs:   Merchant Gateway Manager Supported Merchant Gateway Providers PsiGate (XML API)

© Copyright 2018. Parallels Holdings. All rights reserved.