iono Documentation - PayPal

About

PayPal is an electronic money service which allows you to make payment to anyone online. You can choose to pay using your credit card, debit card, bank account, or PayPal balance and make secure purchases without revealing your credit card number or financial information. All major credit and debit cards are accepted including Visa, Mastercard, American Express, Switch and Solo (plus many more). Visit the PayPal website for more information.

Features

The following features are supported by the gateway and can be handled by iono. In the case of refunds and fee calculations, the details will be logged by iono with the transaction.

Method

The customer clicks the pay button and is taken to the PayPal website. Then the customer is required to create an account before paying although if you have set it up in your account you can have an option to not require a PayPal account. Once the customer has logged in they complete payment and are then taken back to their iono account. iono receives a callback and will log the transaction. You can make light customisations to the PayPal pages that your customer sees during the payment process.

Setup

  1. From the Gateways section of the Settings section of the admin control panel, click on Edit next to the Moneybookers entry.
  2. You can leave all the values as default except the following:
    1. Status: Change to Active
    2. E-Mail: Enter your PayPal account e-mail address
  3. Click Edit and the PayPal gateway is now enabled

The other options can also be changed:

Testing

PayPal supports testing of the gateway module through their Developer Central and Sandbox services. You will need an account at PayPal Developer Central to be able to perform testing through the PayPal test system. To enable the test mode on the gateway:

  1. From the Gateways section of the Settings section of the admin control panel, click on Edit next to the PayPal entry.
  2. Tick the Test Mode option
  3. Click Edit and the PayPal gateway is now in test mode

Callback

Callback in PayPal is called Instant Payment Notification or IPN. Usually you do not need to make any changes to enable the IPN functionality with iono - the IPN URL is provided by default. This means that if you are already using IPN with another application iono will not intefere with it. However, you can also force all IPN callbacks to go to your iono installation. Follow the instructions below to do this:

  1. Login to your PayPal account
  2. Click the Profile option from the submenu of the My Account tab
  3. From the third and last column on the right, click the 5th option down called Instant Payment Notification Preferences
  4. Click Edit
  5. Place a tick in the box and then enter your full callback URL into the box below. The callback URL is displayed beneath the gateway list table on the Gateways page of the Settings section of the iono admin control panel. Replace gatewayname at the end of the URL with paypal.
  6. Click Save and IPN is now enabled and hard coded to direct to your iono installation