Preparation

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

NetBilling 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:

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

Make sure that the direct-java-2.3.3.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:

1. Get registered with the NetBilling and obtain the direct-java-2.3.3.jar file.
2. Put the lib file into in the directory ~cpanel/java_rt/.
3. Edit /hsphere/local/home/cpanel/apache/etc/jserv/jserv.properties to include the following string:
   wrapper.classpath=/hsphere/local/home/cpanel/java_rt/direct-java-2.3.3.jar.
4. Restart H-Sphere

Configuration

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

   

   • Title: give a name to this NetBilling connection
   • Protocol: http or https protocol to connect to the gateway server
   • Server: the name of the NetBilling server
   • Account: your NetBilling account ID
   • Site Tag: your brief site nickname
   • Notification Email for VOID transactions: NetBilling doesn't support VOID transactions. Instead, H-Sphere sends a notification to this address that the transaction needs to be canceled manually through NetBilling web interface.
4. Click Submit Query

CVV (Card Verification Value). To enable fraud protection using CVV, enable and configure CVV support in your NetBilling account. More on CVV credit card verification.