Adyen PayPal Integration Owner's manual

Brand: Adyen

Model: PayPal Integration

Type: Owner's manual

Adyen – PayPal Integration

Version 1.48

Adyen B.V.

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

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

Introduction

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.

Account Setup Overview

Figure 1: PayPal Login Screen

Account Setup Overview

Figure 2: Update API Access

Account Setup Overview

Figure 3: Grant API Permission

Account Setup Overview

Figure 4: Third Party Permission Username

Account Setup Overview

Figure 5: Add Permissions (NOTE: “Generate consolidated reports for all accounts” should also be checked)

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.

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.

Adyen PayPal Integration Owner's manual

Adyen PayPal Integration Owner's manual

Adyen PayPal Integration Owner's manual

Other documents