Adyen – PayPal Integration
Version 1.48
Adyen B.V.
Copyright © Adyen B.V. 2010-2011 1
Table of Contents
Introduction.............................................................................................................................................................3
Audience............................................................................................................................................................ 3
Changelog.......................................................................................................................................................... 3
Account Setup Overview.......................................................................................................................................... 5
Refund Period.....................................................................................................................................................5
Recurring............................................................................................................................................................ 5
iFrame.................................................................................................................................................................... 11
Payment Completion............................................................................................................................................. 12
Bank transfers...................................................................................................................................................12
Shopper Statement................................................................................................................................................ 12
Reporting............................................................................................................................................................... 12
2Copyright © Adyen B.V. 2010-2011
Introduction
Introduction
The purpose of this manual is to facilitate the integration of your platform with the Adyen Payment System
and PayPal. In the following chapters we will cover:
•Account Setup: set up your PayPal account for use by Adyen
•Payment Completion: retrieve the status of payments
•Shopper Statement: submit a variable shopper statement
The latest version of this document is available at:
https://support.adyen.com/links/documentation
To enable PayPal on your accounts please provide the following information to Adyen Support:
•The email address of the PayPal account
•The 13-character Merchant Account ID (found in PayPal under Profile -> My Details)
•The merchant account code(s) it should be added to
Audience
This is a technical manual aimed at IT personnel involved in integrating merchants' systems with those at
Adyen and PayPal.
Changelog
Version Date Changes
1.48 2011-11-22 •Added information about PayPal recurring limits
1.47 2011-10-27 •Added information about additional reporting abilities
•Added requirement for PayPal Merchant Account ID
1.46 2011-08-25 •Changed PayPal screenshots
•Added details about recurring capabilities
1.45 2011-08-05 •Added iFrame section
1.41 2011-03-02 •Changed PayPal screenshots
1.40 2011-01-09 •Changed Paypal screenshots
1.35 2010-12-28 •Added information about Payment Completion part.
1.30 2010-11-30 •Removed Payment Completion part.
1.21 2010-07-29 •Added audience section
•Manual reviewed for English and layout consistency
1.20 2010-06-25 •Added Refund Option section
Copyright © Adyen B.V. 2010-2011 3
Introduction
4Copyright © Adyen B.V. 2010-2011
Account Setup Overview
Account Setup Overview
The merchant should set up a PayPal account and allow Adyen to credit payments on this account. API
permissions must be granted to Adyen in order to allow us to credit payments on your PayPal account and
provide extra reporting . This can be achieved as follows:
●Login to your PayPal account at https://www.paypal.com/ (Figure 1).
●Go to Selling Preferences by hovering over the Profile menu and selecting My Selling Preferences
(Figure 2).
●Click the Update link next to the API access row (Figure 2).
●Click the Grant API permission link (Figure 3).
●Enter the Third Party Permission Username as paypal_api1.adyen.com and click the Lookup button
(Figure 4)
●Select the following API Access Levels;
Use PayPal Express Checkout to process payments.
Issue a refund for a specific transaction.
Process your customers credit or debit card payments.
Authorise and capture your PayPal transactions.
Obtain information about a single transction.
Obtain authorisation for pre-approved payments and initiate pre-approved transactions.
Generate consolidated reports for all accounts.
Use PayPal Express Checkout to process mobile payments. (Not needed if you don't have plans
to support mobile phones)
and click the Add button (Figure 5).
●Submit a ticket via https://support.adyen.com/ which provides us with your PayPal account email
address.
Refund Period
By default the refund option is limited on PayPal accounts to 60 days. On certain accounts PayPal allows
longer refund periods. When this is the case it also needs to be configured on your merchant account in the
Adyen platform. Please advise Adyen Support if this is the case.
Recurring
By default recurring payments are not possible on PayPal. On certain accounts, however, PayPal does allow
this functionality, with a limit placed on the transaction amount of subsequent payments. To request this
functionality please contact PayPal directly and ask them to add merchantInitiatedBilling functionality to your
account. Then ensure the following API Access Levels are also on your PayPal account:
Create and manage Recurring Payments.
Charge an existing customer based on a prior transaction.
Finally, please contact Adyen Support to advise that this functionality has been enabled.
Copyright © Adyen B.V. 2010-2011 5
Account Setup Overview
Figure 1: PayPal Login Screen
6Copyright © Adyen B.V. 2010-2011
Account Setup Overview
Figure 2: Update API Access
Copyright © Adyen B.V. 2010-2011 7
Account Setup Overview
Figure 3: Grant API Permission
8Copyright © Adyen B.V. 2010-2011
Account Setup Overview
Figure 4: Third Party Permission Username
Copyright © Adyen B.V. 2010-2011 9
Account Setup Overview
Figure 5: Add Permissions (NOTE: “Generate consolidated reports for all accounts” should also be checked)
10 Copyright © Adyen B.V. 2010-2011
iFrame
iFrame
At this moment it is not recommended to display the PayPal page in an iFrame. With Medium (default)
security settings in several browsers, like Internet Explorer and Safari, it results in the shopper seeing a security
warning or error page.
Figure 6: PayPal security warning/error message
The reason for this is that pages in the iFrame are marked as third-party (compared to the parent window).
When these sites want to work with a cookie, browsers can act upon this (Allow third party cookies). The
PayPal pages are even a bigger threat since they lack a so called P3P header
(http://en.wikipedia.org/wiki/P3P). This header indicates what kind of info is stored / requested by the website
via a cookie and this is compared with the browsers risk settings. It is therfore no guarantee that a cookie is
accepted when a P3P header is being sent, but it allows the browser to verify in detail if there is no sensitive
data shared.
Adyen is adding functionality on the Hosted Payment Pages that offers automatic functionality that tells the
payment page to "break" out of the iFrame before redirecting to PayPal. Since PayPal is then displayed in the
browser's address bar it is no longer a third party and there are less issues with cookies.
Please note that cookies can be disabled completely in browsers. In this case various payment methods like
PayPal and iDeal are not working anymore. For more information on iFrames or the latest state on the Adyen
feature addition, please refer to the “Using an iFrame” section in Chapter 1 of the Adyen Integration Manual.
Copyright © Adyen B.V. 2010-2011 11
Payment Completion
Payment Completion
When a shopper has completed the payment they are redirected to a default Adyen result page. More
information about the result page and payment completion can be found in the Adyen Integration Manual.
PayPal has a specific way of handling non-completed or refused payments. For a large part of the refusal
payments you will therefore receive PENDING in the result URL. The reason for this behaviour is that PayPal
may offer a shopper to try again.
If the shopper succeeds to successfully complete their payment, you will receive a normal AUTHORISATION
notification with the success field set to true.
Bank transfers
If your PayPal account approves it, it is possible for a shopper to pay via bank transfer to PayPal. This means
that you will receive the AUTHORISATION notification in approximately 5 to 7 days.
Allowing bank transfers also results in the situation that you will never receive a refused payment, because
PayPal never expires the payment.
Shopper Statement
Some acquirers, including PayPal, support a variable shopper statement. To submit a variable shopper
statement you can set the shopperStatement field in the payment request to further improve the shopper
experience. More information about submitting the Shopper Statement Field can be found in the Adyen
Integration Manual.
If no shopperStatement is supplied PayPal will use the merchant reference as the text used for the statement.
Reporting
Please use the External Settlement Report with Info to see information in Adyen pertaining to your PayPal
settlements. The report is the same as our usual settlement reports (available at Merchant level), however is
available at Company level only.
12 Copyright © Adyen B.V. 2010-2011
/
