H-Sphere Reseller Guide

For more information contact us at info@psoft.net

Online Payment Providers
version 2.3 and higher

 

In versions 2.3 and higher, H-Sphere allows payments via online payments providers WorldPay, PayPal (included in version 2.3 RC3) and 2CheckOut (included in version 2.3 RC4), as an alternative to credit card and check payments.

For you to receive payments and for your customers to make payments with:
- PayPal or WorldPay: you should register online business and personal accounts correspondingly;
- 2CheckOut: you should first go to www.2checkout.com to register your online account.

If your customers choose to pay via online payment providers, their credit card info won't be stored in their billing profiles and billing info won't show in the control panel.

 

Setting Up WorldPay

To enable WorldPay transactions in H-Sphere for your customers, do the following:

  1. Select Merchant Gateways in the Settings menu. The following page will show:

  2. Turn on Accept WorldPay to enable WorldPay online transactions. The registration form will show:

  3. Fill the form:
    • Enter your Installation ID, provided to you by WorldPay system upon registration.
    • Enter WorldPay Account ID, provided by WorldPay upon registration.
    • Choose the transactions currency from the drop-down box.
    • Check Use Custom Result Page if you want your customers to receive your custom email payment notifications.
    • Enter the custom page name, which should be exactly the same as in the WorldPay account.
    • Set a test mode variable for testing online transactions via WorldPay:
      • with variable set to 100, H-Sphere will consider all your transactions real. They will be approved that will reflect on user's billing.
      • with variable set to 101, H-Sphere will decline all your WorldPay transactions.
      • with variable set to 0, H-Sphere will perfom real transactions in a live mode.
    • Choose TRUE to enable WorldPay payments for the customers. Note: with this option turned to FALSE, you can temporarily disable signup with WorldPay but store main settings at the same time.
  4. Click Submit Query. On the Merchant Gateway settings page, WorldPay turns ON and shows your account ID in WorldPay system.

During signup process, when clients select WorldPay, they are sent to the WorldPay website and all further payments take place beyond H-Sphere control panel. The scheme of WorldPay account is similar to check account.

 

Setting Callback URL in WorldPay

To configure H-Sphere to receive information about payments made via WorldPay, you need to set a callback URL in your WorldPay account. To do this:

  1. Log into your WorldPay Business account;
  2. In the Installations section, click the Configuration Options icon;
  3. Enter a callback URL (the example URL is given below);
  4. Check Callback enabled box.

Callback URL works as follows:

  • Customer submits a payment form through WorldPay;
  • WorldPay sends notification about payment made to the callback URL you specified.

The example of callback URL is: http://cp.example.com:8080/psoft/servlet/psoft.hsphere.payment.WorldPayServlet

The URL's structure is: CP_PROTOCOL://CP_HOST:CP_PORT/psoft/servlet/psoft.hsphere.payment.WorldPayServlet
where:
CP_PROTOCOL: http or https.
CP_HOST: domain name you host, e.g: cp.example.com
CP_PORT: port of your CP, e.g: 8080
Note: Make sure to enter your actual CP data.

 

Setting Up PayPal

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

  1. In your control panel, select Merchant Gateways in the Settings menu.
  2. On the Merchant Configuration page, click the OFF button next to the Accept PayPal field, to enable PayPal online transactions. The registration form shows:
  3. Enter the required parameters in the form above:
    • PayPal ID: the email you are registered in PayPal with.
    • Pass-Through Value: enter your "custom" variable e.g: "PayPalTest" to match payments with a customer or transaction ID for tracking and identification purposes. It will be passed through the PayPal system and returned to user in payment notification emails.
    • Logo Image URL: image 150 by 50 pixels in size, you would like to use as your logo. This is optional: if not entered, your customers will see your Company Name or email address in place of logo.
    • Enabled: choose TRUE to enable PayPal payments for the customers.
      Note: with this option turned to FALSE, you can temporarily disable signup with PayPal but store main settings at the same time.
  4. Click Submit Query. On the Merchant Gateway settings page, PayPal is turned ON and shows your ID in PayPal system.

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.

 

Instant Payment Notification URL in PayPal

To transfer information about received payments from PayPal to H-Sphere, you need to activate Instant Payment Notifications. To do this, enter a notification or callback URL in your Business PayPal account. PayPal's IPN system works as follows:

  • Customer submits a payment form and PayPal sends notifications about payments made to your notification URL.
  • On receiving the payment notification, your server will send the confirmation, including the encrypted code, back to a secure PayPal URL.
  • PayPal will authenticate the transaction and send your server a "VERIFIED" or "INVALID" response.
  • If verified, the payment is regarded as successfully completed. If you receive an "INVALID" response, it should be treated as suspicious and investigated.

The notification URL can be entered in Profile Summary ->Selling Preferences -> Instant Payment Notification Preferences.
The example of callback URL is: http://cp.example.com:8080/psoft/servlet/psoft.hsphere.payment.PayPalServlet
The URL's structure is: CP_PROTOCOL://CP_HOST:CP_PORT/psoft/servlet/psoft.hsphere.payment.PayPalServlet

where the following values are:
CP_PROTOCOL: http or https.
CP_HOST: domain name you host, e.g: cp.example.com
CP_PORT: port of your CP, e.g: 8080
Note: Make sure to enter your actual CP data.

Get to know more about PayPal Notification URL, and other PayPal documentation in PDF format.

 

Setting 2CheckOut

Once you have your 2CheckOut account registered, you can enable 2CheckOut payments in your control panel. To do it:

  1. In your admin control panel, select Merchant Gateways in the Settings menu.
  2. On the Merchant Configuration page, click the OFF button next to the Accept 2CheckOut field, to enable online transactions:

  3. Enter the required parameters in the registration form that shows:
    • 2CheckOut Merchant ID: your ID provided to you by the 2CheckOut system.
    • Check the box if you want to Use Authorize.Net WebLink parameter names.
    • Choose TRUE in the drop-down box to enable 2CheckOut payments for the customers.
      Note: with this option turned to FALSE, you can temporarily disable signup with 2CheckOut but store main settings at the same time.
  4. Click Submit. On the Merchant Gateway settings page, 2CheckOut is turned ON and shows your ID in the 2CheckOut system.

During a signup process, when clients select 2CheckOut, they are sent to the 2CheckOut website and all further payments take place beyond H-Sphere. The scheme of 2CheckOut account in H-Sphere is similar to a check account.