PayPal Configuration

Before proceeding, make sure to read about Web Payment Systems Manager.


PayPal certificate is trusted by VeriSign Trust Network. Since the standard java cartcerts file doesn't include VeriSign Trust Network public certificate, Parallels 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 Parallels.

B. If you need to keep your cacerts file, you can fix this problem using the keytool feature available in the standard java installation: How do I update my cacerts file? (

Setup Procedure

Once you have registered a PayPal business account, enable PayPal in your control panel:

  1. Select Merchant Gateways in the Settings -> Payment Settings menu.
  2. On the Merchant Configuration page, choose PayPal from the drop-down menu.
  3. Click the Edit button to activate it.
  4. Enter the required parameters in the PayPal form:

    (HS 2.5 and up) Server: the server used to run transactions. It can be or in regards to what you issued certificate for.

    (HS 2.5 and up) Port: enter the port to be used.

    (HS 2.5 and up) Path: indicate the path.

  5. Click Submit Query. PayPal now must show as active.
  6. Set Instant notification URL to receive information about payments made via PayPal.
  7. Log into your Business PayPal account
  8. Go to the Profile Summary ->Selling Preferences -> Instant Payment Notification Preferences.
  9. Enter a callback URL

PayPal's IPN system works as follows:

Parallels H-Sphere supports PayPal multicurrency transactions. Fees are charged in the currency which is set in the admin control panel. To charge users in two different currencies, you need to have two resellers.

PayPal Testing Mode. To run PayPal transactions in testing mode, create a development account at PayPal Sandbox and under this account create fake PayPal accounts for testing purposes. Then, set PayPal sandbox parameters in the PayPal setup form in Parallels H-Sphere:

Port: 443
Path: row/cgi-bin/webscr
Pay Pal ID: fake PayPal account
Pass Code: anything.