|
Preparation
Contact your hosting service provider to work with files on the host server.
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
|
