NetBilling Configuration


NetBilling certificate is trusted by Equifax and provided by GeoTrust. In Java 1.3.x and older the standard java cartcerts file doesn't include GeoTrust root Certificates and therefore Parallels H-Sphere returns 'Connect error, untrusted server cert chain' when trying to connect to the merchant gateway. That's why GeoTrust Root 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 Parallels:

/usr/java/<java home>/jre/lib/security/cacerts

B. Upgrade Java to 1.4 by following our documentation in Sysadmin Guide.

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 [] [port]

Make sure that the direct-java-2.3.3.jar file is present in the /hsphere/local/home/cpanel/java_rt/ directory.

If it's not there:

  1. Contact NetBilling and obtain the direct-java-2.3.3.jar file.
  2. Put the lib file into in the directory ~cpanel/java_rt/.
  3. Restart Parallels H-Sphere.


  1. Select NetBilling in the Add New Gateway box.
  2. Click the Add button.

    Fill out the form that appears:

  3. Click Submit Query

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