|
Preparation
SurePay certificate is trusted by Equifax.
Since the standard java cartcerts file doesn't include Equifax public certificate,
H-Sphere returns 'Connect error, untrusted server cert chain' when trying to
connect to the merchant gateway. The following are the 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:
- Download equifax.crt.cer file:
wget http://www.psoft.net/shiv/files/merchants/equifax.crt.cer
- Place equifax.crt.cer in the /usr/java/jdk1.3.1/jre/lib/security/ directory
- 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
- Log in as the cpanel user:
su -l cpanel
- Go to the /usr/java/jdk1.3.1/jre/lib/security/ directory:
cd /usr/java/jdk1.3.1/jre/lib/security/
- Run the following command:
keytool -import -alias equifax -file equifax.crt.cer -keystore cacerts
- When prompted, enter the password (the default password is: changeit)
- When asked to trust the certificate, enter: yes
- 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
Make sure that the ppsdk.jar file is present in the
/hsphere/local/home/cpanel/java_rt/ directory and the path to this file
is specified in /hsphere/local/home/cpanel/apache/etc/jserv.properties
If not:
- Get registered with the SurePay and obtain the ppsdk.jar file.
- Put the lib file into in the directory ~cpanel/java_rt/.
- Edit /hsphere/local/home/cpanel/apache/etc/jserv.properties to include the following string:
wrapper.classpath=/hsphere/local/home/cpanel/java_rt/ppsdk.jar.
- Restart H-Sphere
Configuration
- Select SurePay in the Add New Gateway box.
- Click the Add button.
- 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
- Click Submit Query
|
