PayPal Module Integration Guide

for a PrestaShop Store

Contents

Introduction

p.3

Which PayPal
Solution Should You Choose?

p.6

Add the PayPal Module

to Your PrestaShop Store

p.7

Access to the PayPal Module

Create a PayPal Account

for Professionals

PayPal Standard

PayPal Hosted Sole Solution

PayPal Express Checkout

p.15

p.18
p.21

To Go Further

Configure your PayPal module

Install PayPal Payment Solutions

p.10
p.11

Activation of Log In with PayPal

FAQ

Confidential & Priorietary

p.26
p.32

Introduction

Confidential & Priorietary

PayPal, a Global Leader in Online Payments

A reliable, simple, and effective payment solution. A definite plus for your customers.

How Does it Work?

On your site:
your customer places
an order.

On your payment
page:
the customer makes
a payment using the
PayPal system to pay
for his/her order.

When the transaction

is complete:
your PayPal account is
immediately credited.

You can transfer your

money free of charge*
to your bank account
or make purchases
online using your
PayPal account.

* If no currency conversion is required

Advantages of PayPal
Your customers do not need to pay any fees for using PayPal.
They do not have to enter their bank details for every payment and can pay for their purchases
by card, bank account, or directly with their PayPal balance, up to 26 currencies.
It is so easy and secure that 148 million users** worldwide have already chosen to make
payments with PayPal. By accepting a wide range of payment methods, your business gains
strength and your customers pay with full confidence.
**Source: Internal 2014 eBay data

Did You Know ...

With PayPal:
You opt for a clear fee schedule, with no hidden costs: you pay a commission for each
transaction whenever you receive a payment. The more you sell, the lower the commission.
You are already selling on mobile devices: your payment page automatically adapts (thanks to
automatic detection on the PayPal payment page).

PURCHASE
PROTECTION

Your customers can benefit from Buyer Protection and know

that they will get delivery or be reimbursed***.
*** Except Russia and all CEE countries. Subject to conditions:
https://www.paypal.com/fr/webapps/mpp/buyer-protection

Activate PayPal as a payment method in your PrestaShop back-office.

Its easy and free.
4

Confidential & Priorietary

Which PayPal Payment Solution

Should You Choose?

Confidential & Priorietary

Personalized Payment Solutions

PayPal Standard
A payment system fully
integrated into your site.

PayPal Hosted Sole

Solution*
An advanced version of
PayPal Standard.

PayPal Express
Checkout

An additional payment method

using a PayPal account.

When should I
choose this solution?

I would like to accept payments by card, charge card, bank account, and
PayPal account.

Description

Be billed only when you receive

payments.

In addition to the benefits of PayPal

Standard:

Ideal if you already accept other

payment methods on your site.

Accept payments by email, even

without having a site

Benefit from a reduced issuing

commission on a sliding scale

Receive payments on eBay

Offer your customers an easy

purchase by adapting your
payment page to your corporate
design and by customizing the
images, colors, and formats.

Also offer your customers a way

to pay with their PayPal account in
just a few clicks. Its so easy and
secure that 143 million users***
worldwide have already chosen
PayPal to make a payment.

I would like to add payment by

PayPal account in addition to
my current payment solutions.

Benefit from cover in case of

dispute, with our Seller Protection
program**

Types of payment
accepted
Installation

Visa, Mastercard, PayPal and all local major electronic payment methods

Skill level required:

Easy

Skill level required:

Intermediate

PayPal

Skill level required:

Intermediate

Did You Know ...

 
% of PayPal buyers in Europe**** abandon their online purchase if PayPal is not offered as
34
a means of payment.
Their reasons are clear:
of
customers surveyed in Europe**** stated they have abandoned their purchase for
%
79
security reasons if PayPal is not available.

22% of customers in Europe**** have said that they prefer the simplicity of paying with
PayPal. The customers that use PayPal regularly to make their purchases recognize that
it is more secure. They are looking for that security, whether on their computer, on a
tablet or on a mobile device.

* Available in France, Italy, Spain

** Subject to conditions: https://www.paypal.com/fr/webapps/mpp/paypal-safety-and-security
*** Source: Internal 2013 data
**** Research conducted by NorthStar in Q4 2013. Based on a sample of 103 large online retailers selected for inclusion and representing
26,653 recent buyers. Sample is not necessarily representative of the large online retailer marketplace as a whole. Survey conducted in
United Kingdom, Turkey, France, Norway, Denmark, Israel, Qatar, United Arab Emirates, Portugal, Netherlands, Spain, Sweden, Germany,
Italy, Poland.
6

Confidential & Priorietary

Add the PayPal Module

to Your PrestaShop Store

To allow you to accept PayPal payment solutions on your site

Confidential & Priorietary

How Do I Add the PayPal Module for PrestaShop?

The PayPal module is free and pre-installed in the PrestaShop store.
Click Payment(1) on the Modules tab
Look for the PayPal Europe module in the drop-down menu or by using the search bar(2)
Click the Install button(3).

2
3

A message(1) will then tell you if the PayPal module was installed successfully.

Congratulations, you have installed the PayPal module for PrestaShop.

You must now activate one of our various payment solutions.

Confidential & Priorietary

Configure Your PayPal Module

Configuration of your PayPal module allows you to accept the various payment methods.

Confidential & Priorietary

How do I Access the PayPal Module?

To access the PayPal module:
On the Module tab(1) click Payment
Click the Configure(2) button for the PayPal module, then Validate

2
1

Now that you have accessed the PayPal module, you are able to configure it as you choose, by
selecting one of the different payment solutions available.
(see page 6):
PayPal Standard

PayPal Hosted Sole Solution

PayPal Express Checkout

NOW THERE ARE TWO DIFFERENT SCENARIOS:

You do not have a PayPal Business account:
Please refer to the following pages to create a PayPal account (essential for receiving your
transactions) directly from your PrestaShop interface, then configure your PayPal module at
your convenience.
Go to page 11

You already have a PayPal Business account:

In this case, you will only need to select Yes next to the question Do you already have a
PayPal Business account? then follow the instructions to retrieve the information required
from your PayPal account to configure your module.
Go to page 15

10

Confidential & Priorietary

Create a PayPal Business Account from PrestaShop

If you do not have a PayPal Business account, you will need to open one when you install your
PayPal module on PrestaShop.
To do so, select No(1) next to the question Do you already have a
PayPal Business account?

Select the PayPal payment solution of your choice (see page 6), then continue with
Step 2: Sign up for a PayPal Business account
Opening the account is free!

11

Confidential & Priorietary

Fill out the form, then click on Continue(1)

Agree and Continue(2) once you have entered the information requested about your business.

Once the PayPal Business account has been created:

Click Go to set-up(1)

Now confirm your email address by clicking the link you will receive in your inbox.

Congratulations, your PayPal Business account on PrestaShop is now activated!

12

Confidential & Priorietary

Once the e-mail address has been confirmed:

Log in using the password you set when you registered, then follow the instructions to
complete the information about your company(1).

You can now start the configuration of your account for receiving payment on PayPal:
Click Send then Set Up Payments(1)

Congratulations, you can now receive payments!

13

Confidential & Priorietary

Installation of PayPal Payment Solutions

PayPal Standard / PayPal Hosted Sole Solution / PayPal Express Checkout

14

Confidential & Priorietary

How Do I Add PayPal Standard?

Log in to your PayPal account, go to the
Tools tab, then click API Access(1).

Request an API Signature on your PayPal Account:

To request an API signature, which you will need to establish
the link to your PrestaShop platform:
Click Go to API Access(1)

15

Confidential & Priorietary

Click Request API Credentials(1)

Select Request API signature(1).

Then click Agree and Submit(2).

Tip: once the procedure is complete, you can Display your API signature(1)
at any time.

16

Confidential & Priorietary

Enter the API data in the PrestaShop back-office:

Once the API signature has been obtained on PayPal, you can enter this data directly into the
PrestaShop platform.
It is important that these data be entered correctly or you will not be able to receive PayPal
payment.
Select PayPal Pro Hosted or Sole Solution(1) in step 1: SELECT YOUR SOLUTION
Configure your solution (step 3) by filling in the fields requested(2).

Congratulations, you have correctly configured PayPal Standard!

17

Confidential & Priorietary

How Do I Install PayPal Hosted Sole Solution?

Select PayPal Pro Hosted or Sole Solution(1) in Step 1: SELECT YOUR SOLUTION
Then click Apply in Step 2.

Next, enter the details of your PayPal account (email + password)

Click Sign in(1)
When you are redirected to the PayPal / PrestaShop page, click Subscribe.

18

Confidential & Priorietary

Subscription to the Service via PrestaShop

After PayPal has validated your registration, you can go back into the back-office of
PrestaShop,
Re-enter the email address for your(1) PayPal account
Click Save.

Congratulations, you have correctly configured PayPal Hosted Sole Solution!

19

Confidential & Priorietary

How Do I Install PayPal Express Checkout?

Just as with the PayPal Standard option, PrestaShop will request your API signature
in order to integrate PayPal Express Checkout.
Log in to your PayPal account, and then go on the Tools tab
Click API Access(1)

Then click Go to API Access(1).

20

Confidential & Priorietary

Click Request API credentials(1).

Select Request API signature(1) then click Agree and Submit(2).

21

Confidential & Priorietary

Enter the API Data in the PrestaShop Back-Office

Once the API signature has been obtained on PayPal, you can enter this data(1)
directly into the PrestaShop platform.
It is important that these data be entered correctly or you will not be able to receivePayPal
payment.

Congratulations, you have correctly configured PayPal Express Checkout!

22

Confidential & Priorietary

To Go Further

Activation of Log In with PayPal

23

Confidential & Priorietary

What is Log In with PayPal?

Login with PayPal is the eCommerce identification solution that allows your customers
to register on your site quickly and safely using their PayPal login information.
With this function, the customer does not have to re-enter the data already recorded in PayPal. You can therefore specifically shorten the buying process, since your customer no longer
has to go through the Account Creation step, while still allowing you to retrieve his/her data.

Recommandation:
Add the Log In with PayPal button to the login and home pages of your site.
For your customers, this function breaks down into 3 steps:
1. Choose to log in with PayPal
2. Enter PayPal login information
3. Share the information with you
1

Account creation form

pre-filled
8 fewer fields to fill in 30-40 seconds saved

24

Confidential & Priorietary

How Do You Install this Function on your Merchant Site?

You need only to follow these 2 steps :
1. Retrieve the data from your PayPal account, called the App-ID,
on the site https://developer.paypal.com
To do so, please follow the steps below.
2. Enter these data into your PrestaShop back-office.
For more information about this function, please go to:
https://developer.paypal.com/webapps/developer/docs/integration/direct/identity/button/

Retrieval of the APP-ID Linked to Your PayPal Account

You must have a live PayPal Business account (active) to perform this step (and not
a PayPal Sandbox account).
Go to: https://developer.paypal.com
Log in using your usual PayPal login details (live account details) and click Log In(1).

25

Confidential & Priorietary

After you are logged in,

Click the Applications tab(1)
Click Create App (2)
1
2

Enter an Application name(1) (for example : Merchant name Login)

Click Create App (2) then click Create app (2) again.

1
2

26

Confidential & Priorietary

You need yourLive Credentials data (and not test credentials)

Click show to display them.

These are the Client ID (1) data andSecret (2) datathat you should copy and then paste
into the PrestaShop back-office.
You will also need then to fill in the App return URL (live) field.
Click on the Edit(3) hypertext link next to App redirect URLs to show the hidden form.
Copy and customize the following URL address in App return URL (live)(4) :
{url_of_your_website}/modules/paypal/paypal_login/paypal_login_token.php
ex : http://mywebsite.com/modules/paypal/paypal_login/paypal_login_token.php

1
2

27

Confidential & Priorietary

In order to test the function in a test environment, you can use the Client ID and Secret data
of the paragraph test Credentials.
At this stage, you have the data that should be copied into the PrestaShop back-office.
So that the function will be operational, you still have to proceed to the following verifications:
In the section App Capabilities(1), check that the Accept Payments etLog In with PayPal boxes
are checked(1).

28

Confidential & Priorietary

 Then, in the Log In with PayPal section of App Capabilities, click Advanced Options.
Check the 3 boxes Personal Information(1), Address Information(2) et Account Information(3)
so that PayPal sends you the information about your customer.
Leave all of the subcategories checked as well; you will then choose in the PrestaShop
back-office the customer data that you want to obtain.
Enter the URL of the privacy policy and user agreement in the fields Privacy policy URL(4)
andUser agreement URL(5).
This information is mandatory since it will appear on the log in page at PayPal Login (to display
this page, click Preview the customer consent page).
If you use Option +, it is possible for your customer to pay with PayPal without having to log
back in to his/her PayPal account at the time of payment. To enable this, check Use Seamless
Checkout (6).

1
2
3

4
5

29

Confidential & Priorietary

The fieldAllow the customers who havent yet confirmed their email address with PayPal, to log
in to your app allows the users who have not yet confirmed their PayPal account to use
the function.
You have the choice to activate this function or not.
Configuration is complete! Click Save.

These App-ID data(1) must now be pasted into the PrestaShop back-office.

The Client ID and Secret data from the Live credentials you retrieved previously must now be
entered in the PrestaShop back-office to finish setting up this function.
All done! Your customers will now be able to make purchases
on your site more rapidly.

30

Confidential & Priorietary

FAQ

31

Confidential & Priorietary

How can I personalize my payment page?

You can do this from your PayPal account. In Preferences > My sales > Personalization of the
payment page. You will find a list of the style sheets. The default style sheet is called PayPal.
You will have to add a new one that you may call whatever you wish. Specify the URL for your
logo and the colors you would like for the frame. Be careful: the images used must be hosted in
https, since the PayPal payment page is secure and requires that all the elements displayed also
be secure. When you have created this new style page, do not forget to make it default.
How does the shortcut button work?
The shorcut button redirects the buyer to the PayPal login page. After authentication, the buyer
validates the delivery address that is already recorded in his/her account and returns to your site
to validate the payment. His/Her delivery information is communicated to your site, where a buyer
account can be created if one does not already exist.
What is the difference between the two types of payment: direct and authorization?
The direct mode means that the money moves instantly from the buyers account to the sellers
account at the time of payment. The authorized mode is a deferred mode of payment that
requires the funds to be collected manually when you want to transfer the money. This mode is
used if you want to ensure that you have the merchandise before depositing the money, for
example. Be careful, you have 29 days to collect the funds.
How do I use the module with a test account?
You can create test accounts at http://developer.paypal.com. To do a full test on your site, you
will need a buyer (personal) account and a seller (business) test account. You will then have to
activate the sandbox mode on the module and enter the API identifiers for your test account. To
make a payment, use your test buyers account.
Why is the shortcut button not displayed when I activate it in the module?
Check that the graphic theme that you use allows for display of the PayPal button.

If you would like someone from the PayPal team contact you:
Country
IT

https://www.paypal-viewpoints.com/IT-contactus

ES

https://www.paypal-viewpoints.com/ES-contactus

PT

https://www.paypal-viewpoints.com/PT-contactus

BE

32

Form

https://www.paypal-viewpoints.com/BE_FR-contactus
https://www.paypal-viewpoints.com/BE_NL-contactus

NL

https://www.paypal-viewpoints.com/NL-contactus

PL

https://www.paypal-viewpoints.com/PL-contactus

RU

https://www.paypal-viewpoints.com/RU-contactus

Confidential & Priorietary

Thank you

If you need help with your installation, visit the online forum on the PrestaShop web site, which
is managed by user.
If you run into a problem and think it is a bug, please report it on the site
http://forge.prestashop.com.