Preparation

ThePayDesk certificate is trusted by Comodo Trusted Network. Since the standard java cartcerts file doesn't include Comodo Trusted Network root 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:

1. Download GTECyberTrustRoot.cer file:
   wget http://www.psoft.net/shiv/files/merchants/GTECyberTrustRoot.cer
2. Place GTECyberTrustRoot.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 root -file GTECyberTrustRoot.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

Configuration

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

   

   • Title: give a name to this ThePayDesk connection
   • Server: the name of the ThePayDesk server
   • Port: the port of the ThePayDesk server
   • Path: the path to the server side handler file. This can be a script or a binary file that is launched with an http request.
   • Login: your ThePayDesk login
   • Merchant Id: the code given to you by ThePayDesk. This is NOT the merchant number supplied by your bank
   • Notification Email for VOID transactions: ThePayDesk doesn't support VOID transactions. Instead, H-Sphere sends a notification to this address that the transaction needs to be canceled manually through ThePayDesk web interface.
4. Click Submit Query