Parallels H-Sphere Documentation Administrator Guide

 

Web Payment Systems Manager

 
 

Related Docs:   Supported Web Based Payment Providers Processing Check Payments Merchant Gateway Manager

Last modified: 26 Dec 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

     

Configuring Web Payment Systems:

    2CheckOut
    Authorize.Net
    ChronoPay
    GestPay
    PayNova
    PayPal
    Sentry
    Webmoney
    WorldPay

Unlike Merchant Gateways, Web Payment Systems require that users make payments through their payment web page.

 

Work Principles

Once you have registered an account with such a gateway, you enter the account details in H-Sphere. When clients select a web payment system during signup, H-Sphere passes account ID, amount payable, and possibly other details to the gateway. The user is then taken to the gateway's web payment page to enter the credit card number and complete the transaction. When H-Sphere receives a payment notification, it creates the account.

Since H-Sphere doesn't store credit card numbers of customers using web payment systems, further payments are also made outside H-Sphere.

 

Configuration Procedure

To configure a web payment system with H-Sphere:

  1. Register an online account with this web payment system.
  2. In H-Sphere admin control panel, select Merchant Gateways in the Settings -> Payment Settings menu:
  3. Select the payment system from the drop-down menu and click Edit:
  4. Enter your account settings (for instructions, follow links in the blue box on the right).
  5. Once you enter correct settings, the web payment system will appear in the list as active:

Deactivating a payment system disables it for new signups and existing accounts. Although the gateway settings will be preserved, users won't be able to make payments from H-Sphere. You can also deactivate payment systems from their configuration pages.

 

Setting Web Payment Instant Notification URL

Some Web payment systems, like PayPal, WorldPay and GestPay require setting the so-called instant notification URL used by your Web payment system to report H-Sphere about received customer payments.

  • In H-Sphere 2.5 and up

    In H-Sphere 2.5 Beta 1 and up, H-Sphere instant notification URL has uniform format for all supported Web payment systems:

    The URL structure is: CP_PROTOCOL://CP_HOST:CP_PORT/psoft/servlet/psoft.hsphere.PaymentServletName.payment

    Here:

    • 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 (it may have a different look if customized),
    • PaymentServletName is set in the ~cpanel/shiva/psoft/hsphere/merchants.xml XML config file as the servlet attribute of the processor tag for a respective Web payment system.

    For example, for PayPal instant notification URL will look like:

    http://cp.example.com:8080/psoft/servlet/psoft.hsphere.PayPal.payment

    For WorldPay instant notification URL will look like:

    http://cp.example.com:8080/psoft/servlet/psoft.hsphere.WorldPay.payment

    For GestPay instant notification URL will look like:

    http://cp.example.com:8080/psoft/servlet/psoft.hsphere.GestPay.payment

  • In H-Sphere 2.4.x

    The URL structure is: CP_PROTOCOL://CP_HOST:CP_PORT/psoft/servlet/psoft.hsphere.payment.PaymentServletName

    Here:

    • 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
    • PaymentServletName: the servlet attribute of the processor tag for a respective Web payment system
      Note: Make sure to enter your actual CP data.

    For PayPal instant notification URL will look like:

    http://cp.example.com:8080/psoft/servlet/psoft.hsphere.payment.PayPalServlet

    For WorldPay instant notification URL will look like:

    http://cp.example.com:8080/psoft/servlet/psoft.hsphere.payment.WorldPayServlet

    For GestPay instant notification URL will look like:

    http://cp.example.com:8080/psoft/servlet/psoft.hsphere.payment.GestPayServlet


Related Docs:   Supported Web Based Payment Providers Processing Check Payments Merchant Gateway Manager



© Copyright 2017. Parallels Holdings. All rights reserved.