H-Sphere Reseller Guide

SurePay Configuration

(versions 2.3 RC3 to 2.3.2)

 

Related Docs:  

Merchant Gateway Manager

SurePay is now managed and controlled by LinkPoint International, the company that powers YourPaySM payment services. For configuration, see guide on Linkpoint API.

 

Preparation

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

SurePay certificate is trusted by Equifax. In Java 1.3.x and older the standard java cartcerts file doesn't include Equifax public certificates and therefore H-Sphere returns 'Connect error, untrusted server cert chain' when trying to connect to the merchant gateway. Therefore Equifax certificates should be imported into cacerts file.

So, if you have Java 1.3 and older, you have the following solutions:

A. If you have got the default java cacerts file and you have never changed it, you can simply replace it with the cacerts file offered by psoft:
/usr/java/<java home>/jre/lib/security/cacerts

B. If you need to keep your cacerts file, you can fix this problem using the keytool feature available in the standard Java installation:

  1. Download equifax.crt.cer file:
    wget http://www.psoft.net/shiv/files/merchants/equifax.crt.cer
  2. Place equifax.crt.cer in the /usr/java/jdk1.3.1/jre/lib/security/ directory
  3. As root, allow read/write access to the /usr/java/jdk1.3.1/jre/lib/security/cacerts file
    chmod 666 /usr/java/jdk1.3.1/jre/lib/security/cacerts
  4. Log in as the cpanel user:
    su -l cpanel
  5. Go to the /usr/java/jdk1.3.1/jre/lib/security/ directory:
    cd /usr/java/jdk1.3.1/jre/lib/security/
  6. Run the following command:
    keytool -import -alias equifax -file equifax.crt.cer -keystore cacerts
  7. When prompted, enter the password (the default password is: changeit)
  8. When asked to trust the certificate, enter: yes
  9. As root, change permissions back on the /usr/java/jdk1.3.1/jre/lib/security/cacerts file:
    chmod 444 /usr/java/jdk1.3.1/jre/lib/security/cacerts

C. Upgrade Java to 1.4 by following our documentation.

Note: If your certificate is already imported into cacerts, but Java still generates 'Connect error, untrusted server cert chain', please check the connection to your payment server from your control panel server by running the following command from the control panel server console to check connection:
telnet [server.name] [port]

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

If it's not there:

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

 

Configuration

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

    • Title: give a name to this SurePay connection
    • Merchant Id: the code given to you by SurePay. This is NOT the merchant number supplied by your bank
    • Server: the name of the SurePay server
    • Port: the port of the SurePay server
    • URL File: the .dll file path that you got from SurePay. As of the current version, you should enter just a slash (/)
    • Currency: the currency in which your end users will be charged
    • Password: the password which comes with login/username
  4. Click Submit Query

 


Related Docs:  

Merchant Gateway Manager



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