PayPal Module Integration Guide

for a PrestaShop Store

Contents

Introduction p.3 Install PayPal Payment Solutions

Which PayPal PayPal Standard p.15

Solution Should You Choose? p.6
PayPal Hosted Sole Solution p.18
Add the PayPal Module
to Your PrestaShop Store p.7 PayPal Express Checkout p.21

Configure your PayPal module To Go Further

Access to the PayPal Module p.10 Activation of Log In with PayPal p.26

Create a PayPal Account FAQ p.32

for Professionals p.11

Confidential & Priorietary

Introduction

3 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: On your payment When the transaction You can transfer your
your customer places page: is complete: money free of charge*
an order. the customer makes your PayPal account is to your bank account
a payment using the immediately credited. or make purchases
PayPal system to pay online using your
for his/her order. 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
Your customers can benefit from Buyer Protection and know
PROTECTION
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.

It’s easy and free.

4 Confidential & Priorietary

Which PayPal Payment Solution
Should You Choose?

5 Confidential & Priorietary

Personalized Payment Solutions

PayPal Standard PayPal Hosted Sole PayPal Express

A payment system fully Solution* Checkout
integrated into your site. An additional payment method
An advanced version of
PayPal Standard. using a PayPal account.

When should I
choose this solution?
I would like to accept payments by card, charge card, bank account, and
I would like to add payment by
PayPal account in addition to
PayPal account.
my current payment solutions.

Description • Be billed only when you receive
payments.
• Accept payments by email, even
without having a site
• Receive payments on eBay
In addition to the benefits of PayPal Ideal if you already accept other
Standard: payment methods on your site.
• Benefit from a reduced issuing • Also offer your customers a way
commission on a sliding scale to pay with their PayPal account in
just a few clicks. It’s so easy and
• Offer your customers an easy
secure that 143 million users***
purchase by adapting your
worldwide have already chosen
payment page to your corporate
PayPal to make a payment.
design and by customizing the
images, colors, and formats.
• Benefit from cover in case of
dispute, with our Seller Protection
program**

Types of payment
Visa, Mastercard, PayPal and all local major electronic payment methods PayPal
accepted

Installation Skill level required: Skill level required: Skill level required:
Easy Intermediate Intermediate

Did You Know ...

34
 
% of PayPal buyers in Europe**** abandon their online purchase if PayPal is not offered as
a means of payment.

Their reasons are clear:

79
of
% customers surveyed in Europe**** stated they have abandoned their purchase for
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

7 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).

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.

8 Confidential & Priorietary

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

9 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

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.

1
2

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 Pay-
Pal. 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

Account creation form

pre-filled

8 fewer fields to fill in -

30-40 seconds saved

2 3

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)

• Enter an Application name(1) (for example : ‘Merchant name – Login’)

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

26 Confidential & Priorietary

You need your “Live Credentials” data (and not test credentials)

• Click show to display them.

These are the Client ID (1) data and Secret (2) data that 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

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 et Log 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)
and User 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

29 Confidential & Priorietary

The field “Allow the customers who haven’t 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 buyer’s account to the seller’s
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 buyer’s 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 Form
IT https://www.paypal-viewpoints.com/IT-contactus
ES https://www.paypal-viewpoints.com/ES-contactus
PT https://www.paypal-viewpoints.com/PT-contactus
https://www.paypal-viewpoints.com/BE_FR-contactus
BE
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

32 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.