H-Sphere Reseller Guide

For more information contact us at info@psoft.net

PayPal Configuration
version 2.3 RC3 and higher

 

Related Docs:  

Processing Check Payments

PayPal payments are similar to check payments in that they are added to H-Sphere manually.

To receive payments through PayPal, register an online business 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 PayPal

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

  1. 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 structure is: CP_PROTOCOL://CP_HOST:CP_PORT/psoft/servlet/psoft.hsphere.payment.PayPalServlet

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.

More on PayPal notification URL
PayPal documentation in PDF format


 


Related Docs:  

Processing Check Payments



© Copyright 1998-2003. Positive Software Corporation.
All rights reserved.