PayPal Prestashop
PayPal Prestashop
PayPal official
PrestaShop Module
As the leading online payment company, PayPal offers a range of easy, fluid & secure solutions trusted by more than 220M users.
With this module, benefit from our complete payment platform and grow your business online, on mobile & internationally.
* This documentation is related only to PrestaShop 1.7. An upcoming version for 1.6 will soon be delivered.
SUMMARY
User documentation 1
Product matrix 3
Payement methods 4
Test environments 4
Requirements 5
Configuration 6
Payment actions 8
PrestaShop payment preferences 9
Order status 10
Refund and partial refund 13
Express Checkout Shortcut 14
In-context 18
«Pay in X» banners 19
PayPal Plus 22
Anforderungen 23
Konfiguration 23
PayPal PLUS im Checkout 24
Annex 25
Contacts 28
• PayPal Express Checkout is adapted if you want to process PayPal transaction only. • PayPal Plus is for German market only and is offering the possibility to pay with
different payment method (PayPal, Pay Upon Invoice, SEPA, Sofort). If «Germany»
• PayPal Express Checkout Guest is fitted if you want to process PayPal transaction is the default country for your shop you have to configure PayPal Plus Germany.
and offer the possibility to all customers to pay as guests by entering all their
personal information in addition to their credit card information securely. • PayPal Plus Mexico & Brazil is the best solution if you sell in Mexico or Brazil. It
allows to process PayPal transaction and pay by card with multiple installments and
«remember card» option.Б
According to the selected payment solution, you can enable different The PayPal Sandbox is a self-contained, virtual testing environment that
payment methods on your PrestaShop website: mimics the live PayPal production environment. It provides a shielded
space where you can initiate and watch your application process the
requests you make to the PayPal APIs without touching any live PayPal
• PayPal: PayPal account with all linked funding sources
accounts.
• Cards: Visa, Mastercard, Amex, Discover, JCB, Diners, Maestro (Europe),
UnionPay (Europe)
In PrestaShop PayPal module you have the ability to process payments in PayPal
Sandbox, in order to test your PayPal integration.
You can enable the Sandbox mode directly after module installation in the in the upper
right corner. You can see the blue background color once the Sandbox mode is enabled :
It allows you to test our payment solution before creating your PayPal account.
Requirements
TLS, CURL, PHP version and other requirements for module 2. Rounding settings (Shop Parameters – General)
installation Your rounding settings are not fully compatible with PayPal requirements. In order
to avoid some of the transactions to fail, please change the PrestaShop rounding
mode in Preferences > General to:
1. TLS 1.2 & cURL 1.0.1c • Round mode: «Round up away from zero, when it is half way there (recommended)»
The Payment Card Industry (PCI) Council has mandated that early versions of • Round type: «Round on each item»
TLS be retired from service. All organizations that handle credit card information • Number of decimals: «2»
are required to comply with this standard. As part of this obligation, PayPal has
upgraded its services to require TLS 1.2 for all HTTPS connections.
Connections to the sandbox environment use only TLS 1.2.
For more official, relevant information, see the 2017-2018 Merchant Security
Roadmap Microsite:
- Sale: the money moves instantly from the buyer’s account to the seller’s account at
the time of payment.
- Check requirements : Is SSL enabled on your shop? Are you using the required TLS
Note: You can switch to the “sandbox”/“test” mode before activating your payment
version? There is a automatic check of the requirements in the module. (p.11)
solution.
4) Brand name shown on top left during PayPal checkout: A label that overrides the
business name in the PayPal account on the PayPal pages.
If you are using PayPal Checkout redirect you can also customize your shop logo. The
logo can be changed via your business profile settings.
1. Authorization 2. Sale
PayPal authorization and capture is a settlement solution that provides increased Sale transactions charge the specified amount against the account and marks the
flexibility in obtaining payments from buyers. During a traditional sale, the authorization transaction for immediate fund transfer during the next settlement period.
and capture occur at the same time as the sale. However, you use an explicit
authorization and capture call to separate the payment authorization from the capture
of the authorized payment.
• A 29-day valid period that begins when the buyer authorizes the payment. During
this period, the authorization places the buyer’s balance on hold to ensure that the
payment amount is available for capture.
• A 3-day honor period, which is from day one to day three of the authorization
period. After most successful authorizations, PayPal honors 100% of authorized
funds during the honor period. A day starts at 12 AM PST and ends at 11:59 PM PST
on the calendar day when the authorization occurs.
Note: Buyers and merchants cannot close accounts that have pending authorizations.
PrestaShop allows you to manage PayPal payment preferences via the PrestaShop standard menu: Payment → Preferences.
This is where you decide what payment modules are available for different variations like your customers’ currency, group, and country. A check mark indicates you want the payment
module available. If it is not checked then this means that the payment module is disabled.
Please make sure that restrictions in your module takes into account your PayPal solution’s restrictions (see the Product Matrix).
First default currency that will be assigned will be the one set during your onboarding flow.
There are multiple order statuses that can be managed by the PayPal module (see the matrix below).
Refunded Refund the entire order Refund the entire order if it has been captured
No action, the status appears only if an error occurred during No action, the status appears only if an error occurred during
Payment error
the validation process with PayPal the validation process with PayPal
Waiting for PayPal No action, the status appears if an authorization has been
-
payment done with PayPal
On your PrestaShop, you can setup Express Checkout Shortcut in two different ways:
a) By adding the Shortcut on the shopping cart page (normal integration)
• In the cart:
4. At this last step the order will be confirmed and the total amount will be paid with
the selected PayPal account.
Since the v5.3.0 of the module, the advanced settings are added to the module
(«Experience» tab) in order to provide the most customizable solution possible.
You can customize the display options and styles of the PayPal shortcuts. They can be
changed for each button separately depending on their location.
These customization options will be shown only if the shortcuts are enabled at least for
one location (Cart Page / Product pages/ Sign up step in checkout).
You can choose the display styles of the button in the Front Office. The current button is
displayed to have a quick view of the current PayPal shortcut styles. The customization
options will be displayed on click on «Customize». The Live preview of changes will be
displayed on the left: once one of the parameters is changed the preview button changes
the styles.
The following parameters can be customized :
If some elements added via other modules are displayed on the same hook, you can • Color: gold, blue, silver, white, black
manage the position of the PayPal Official module via «Design - Positions». • Shape: rectangle or pill
• Size: width & height
• PrestaShop Widget • Label: PayPal Buy Now button, simple PayPal logo, Checkout, Pay With PayPal
To display the PayPal button via a widget it will be necessary to copy the widget code
and to add it to the template at the desired location.
With In-Context enabled, PayPal opens in a pop-up window, allowing your buyers to
finalize their payments without leaving your website. Optimized, modern, and reassuring
experience which benefits from the same security standards than during a redirection to
the PayPal website.
On desktops, customers check out in a secure window that overlays your website. On
tablets and smartphones, the PayPal payment screens are optimized for full-page mode.
Once your customer choose to pay with PayPal it will be possible to pay directly by
adding required informations via pop-up (so, he will not be redirected to another page in
the new tab):
Once your client is connected to his account he will be able to validate the payment. The
standard payment process (explained in the previous example) will be done.
• Guest Experience
Guest experience is an alternative which doesn’t provide an optimal experience as
it’s asking several information
It is up to PayPal to decide if the «Pay in X» option can be offered when a customer pays
Display «Pay in X» on your site and get more customer
via PayPal :
engagement
There are also some conditions regarding the purchase amount. It depends on the
Eligibility for merchants
customer’s currency. The details are indicated in the pop-in shown via the «Learn more»
button on the banner.
At the moment, this option is available for the following countries :
• Example of banner for eligible amount:
France, United Kingdom, United States, Germany.
You can promote Nx PayPal Payment only if you are a merchant based in one of these
countries and this country is selected as the «default country» in your shop.
The banners can be shown in the Front Office only if the shop currency is corresponding
to these countries :
- EUR, USD, GBP;
and the ISO code is one of these:
- FR, EN, GB, DE.
• Home Page
US Pay in 4 $30 to $1500
• Category pages
Here is an example of the banner shown on the Home or Category page in the Front
FR Pay in 4 €30 to €2000
Office:
• Product pages:
Promote Pay in 3 on your site
Let customers know they have the flexibility to buy now and pay later by adding «Pay in
X» promotional messaging to your site. You can enable the display of the banners via the
« Payment in Nx» tab in your Back Office:
• Choose a color
You can choose the styles of the banner shown on the Home page and category pages in
order to fit better the styles of your shop.
The list of colors may vary depending on your shop country.
Die wichtigsten Bezahlarten mit nur einer Der volle PayPal Service – auch für Kunden ohne PayPal Konto
Auch Kunden ohne PayPal-Konto können über das PayPal PLUS-Modul bei Ihnen
Integration: PayPal PLUS einkaufen und bezahlen – sie bezahlen einfach mit ihrer Kreditkarte, per Rechnung
oder Lastschrift. Dennoch greift bei jeder Transaktion über PayPal PLUS der PayPal
Das PayPal PLUS Modul macht es Ihnen einfach, Ihren Kunden die wichtigsten vier Verkäuferschutz. Und Sie sind vor eventuellen Zahlungsausfällen geschützt – auch wenn
Bezahlarten anzubieten. Mit nur einer Integration ermöglichen Sie es Ihren Käufern, Ihr Kunde per Rechnung, Kreditkarte oder Lastschrift bezahlt.
im Checkoutfenster zwischen einer Bezahlung mit Kreditkarte, Rechnung, PayPal oder
Lastschrift zu wählen. Warum genau diese vier? Untersuchungen haben gezeigt, dass sie Sie erhalten Ihr Geld sofort – egal, wann Ihr Kunde zahlt
die beliebtesten Bezahlarten* im Internet sind – mit der Komplettlösung PayPal PLUS Besonders beim Kauf auf Rechnung und Lastschrift schätzen Shopinhaber PayPal PLUS –
decken Sie ganz einfach die Wünsche von über 90% der deutschen Online-Shopper [1]
ab. denn egal, wann Ihr Kunde bezahlt, Sie erhalten die Summe sofort bei Kaufabschluss von
PayPal gutgeschrieben. So entfällt das aufwändige Kontrollieren von Zahlungseingängen
[1] ECC-Payment-Studie Vol. 22: Der Payment-Markt aus Sicht der Händler und Konsumenten (2017). und Sie können die beliebtesten Zahlungsarten anbieten – um das Risiko- und
Forderungsmanagement kümmert sich PayPal für Sie.
Warum PayPal PLUS? Das Komplettpaket für Ihren Shop
Mit dem PayPal PLUS Modul ist nicht nur die Integration der verschiedenen Bezahlarten
in Ihrem Shop schnell und einfach – auch die Abwicklung der Bezahlung ist dank dieser
Komplettlösung für Sie unkompliziert.
3. PrestaShop Orts-Einstellung
Muss auf „Deutschland“ eingestellt sein, sonst wird PayPal Plus nicht als
Zahlungsoption angeboten
1. Aktivieren Sie die Sandbox: Richten Sie PayPal in der Testumgebung ein (“Ja”,
wenn Sie Entwickler sind).
3. Wählen Sie Logodatei: Ein Bild muss auf einem sicheren Server (https)
gespeichert werden. Verwenden Sie ein gültiges Grafikformat wie .gif, .jpg oder
Fertig!
.png. Begrenzen Sie das Bild auf 190 Pixel Breite und 60 Pixel Höhe. PayPal
beschneidet Bilder, die größer sind. Dieses Logo ersetzt den Markennamen oben im
Warenkorbbereich.
GO LIVE
1. That your PayPal account has been validated from an email verification
standpoint and from a KYB stand point
3. Make a Live payment (with a 0.01 price product) test in order to ensure that
all payments works perfectly
Solution:
Solution:
Following the recent update of the Paypal’s side, you must ensure that your site is always
This error can be caused by an incorrect API username, an incorrect API password, or
compatible after the new update. Please contact your server provider for being sure that
an invalid API signature. Make sure all three values in your PayPal account are correctly
your web site is compatible withe the requirements.
configured.
1. Upgrading to TLS 1.2 and HTTP / 1.1: Your server must be able to support these
protocols.
Note: you will need at least a version of OpenSSL greater than or equal to 1.0.1 and
if you use cURL, a version greater than or equal to 7.34.0.
Also verify that your server has any DigiCert root certificates: https://www.paypal.
com/be/smarthelp/article/remove-support-of-verisign-g5-root-certificate-
ts2240
2. Upgrading the SSL Certificate: In order to decrypt the new certificates, your
website must be able to support the use of the SHA-256 signature algorithm.
We invite you to contact your host to ensure that your server has all these prerequisites.
Solution:
You can try to fix this issue if you change the next configuration on your Prestashop and
after that, you make a payment test with the same kind of order, in one product with
several quantities.
Go to Preferences > General and check the following settings:
The problem is that PayPal and PrestaShop do not calculate rounding in the same way,
but normally by configuring your PrestaShop as this should correct.
Solution:
Please discover the solution on the PayPal official web site:
https://www.paypal.com/us/smarthelp/article/how-do-i-withdraw-money-to-my-
local-bank-account-faq1189#businesslocal-bank-account-faq1189#business
1.6. Error message after the update of the order status in PrestaShop
Solution:
Please go to your PayPal account and check the same order there. If you have already
changed the status of the transaction on PayPal, for example to Canceled/Refunded,
you may get this error in the PrestaShop back office if you update the order status : as
PayPal sends the request of cancellation, and sees that order has already been canceled,
it gives you an error.
To fix such problems, please go to module “Experience” tab> “Customize order status” >
“Order Status for triggering the refund on PayPal”> and select “choose status”. After this,
please update the order status on the PrestaShop (the update of the transaction status
will not be triggered on PayPal and there will be no errors).
Anyway, it is recommended to change the status via the PrestaShop Back Office. By
default, the module allows you to update the transaction status on PayPal automatically
following the change of the status on PrestaShop.