PayPal Manual. Version: Contact details. Simon Carmiggeltstraat DJ Amsterdam. P.O. Box EB Amsterdam The Netherlands

Transcription

1 PayPal Manual Version: 2.03 Contact details Simon Carmiggeltstraat DJ Amsterdam P.O. Box EB Amsterdam The Netherlands T E support@adyen.com

2 Table of Contents 1.Introduction Confguring your PayPal Live Account Refund Period Recurring Sandbox accounts setup overview Creating PayPal Sandbox Business and Personal Accounts Confguring your PayPal Sandbox Business account Making test payments iFrame Payment Completion Bank transfers Shopper Statement Reporting / 20

3 Changelog Version Date Changes Minor changes to screenshots Updated API Access level exceptions in certain countries Updated PayPal recurring information Upgraded to latest Adyen Manuals' formatting and renewed screenshots (based on latest PayPal website to date) Added information regarding PayPal Sandbox setup Added information about PayPal recurring limits Added information about additional reporting abilities Added requirement for PayPal Merchant Account ID Changed PayPal screenshots Added details about recurring capabilities Added iframe section Changed PayPal screenshots Changed PayPal screenshots Added information about Payment Completion part Removed Payment Completion part Added audience section Manual reviewed for English and layout consistency Added Refund Option section 3 / 20

4 Audience This is a technical manual aimed at IT personnel involved in integrating merchants' systems with those at Adyen. The latest version of this document is available here: General Tips/Warnings Defensive Programming Adyen strongly recommends the use of defensive programming when integrating with the Adyen Services. This implies that automated decisions programmed into your systems should be defaulted to non-delivery of products and services. In other words, program your systems to only deliver products and/or services after receiving an explicit authorisation of the requested payment and NOT to deliver in situations where an explicit rejection is not received. Feedback You can provide feedback about this document by sending an to the following address: support@adyen.com We appreciate your comments. 4 / 20

5 1. 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: 'Live' PayPal Account Setup 'Sandbox' PayPal Account Setup PayPal specifc technicalities Information about status updates, iframes, shopper statement and reporting. The latest version of this document is available at: To enable PayPal on your Adyen merchant accounts, you just need to provide the following: For Live Adyen acount The address of your 'Live' PayPal account. For Test Adyen account (OPTIONAL) The address of your Paypal Sandbox Business account. 2. Confguring your PayPal Live Account The merchant should set up a PayPal 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 done by following these steps: Login to your PayPal account at (Figure 1). Click on Profle. (Figure 2). Under Selling Preferences, click the Update link next to the API Access row (Figure 3). Click the Grant API permission link (Figure 4). Enter the Third Party Permission Username as paypal_api1.adyen.com and click the Lookup button (Figure 5) Select the following API Access Levels ; a) Use Express Checkout to process payments. b) Issue a refund for a specifc transaction. c) Process your customers credit or debit card payments. d) Authorize and capture your PayPal transactions. e) Obtain information about a single transaction. f) Obtain authorization for pre-approved payments and initiate pre-approved transactions. a) Generate consolidated reports for all accounts. (In some countries you might get the error: These features are not available in the country where you have your PayPal account. In that case, you can leave this feld unchecked.) g) Use Express Checkout to process mobile payments. (Not needed if you don't have plans to support mobile payments) Once done, click the 'Add' button (Figure 6). Submit a ticket informing Adyen about your PayPal account address via 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 confgured on your merchant account in the Adyen platform. Please 5 / 20

6 advise Adyen Support if this is the case Recurring By default recurring payments are not enabled in Paypal. You can enable it by checking the following two extra permissions at the Third Party permission screen: i) Create and manage Recurring Payments. j) Charge an existing customer based on a prior transaction. Enabling these two options allows you to perform recurring transactions via the Adyen Platform by calling and using the recurringdetailreference for each subsequent recurring transaction via API (see our Recurring Manual). If you would like PayPal to remember the frequency to charge the shopper without the need for individual API calls to the merchant, you would have to confgure it separately at PayPal yourself (see setup of Reference Transactions and Recurring Payment Profles at PayPal's website): This is however not recommended for Adyen merchants as recurring transactions initiated by PayPal (outside of the Adyen platform) will not be visible in your Adyen back ofce. Figure 1: Log in to PayPal 6 / 20

7 Figure 2: Click on Profle Figure 3: Click on 'Update' next to API Access 7 / 20

8 Figure 4: Grant API permission Figure 5: Enter Adyen's 'Live' API username 8 / 20

9 igure 6: Give the required permissions to Adyen's API user and click 'Add' 9 / 20

10 3. Sandbox accounts setup overview Merchants can choose to set up PayPal in Adyen's Test environment. For this, special PayPal Sandbox accounts need to be made. Similar to the 'Live' PayPal account, they need to be then confgured such that the Adyen Test API user can access it on your behalf to perform the necessary test payment operations Creating PayPal Sandbox Business and Personal Accounts There are two kinds of PayPal Sandbox accounts: 1) 2) Business Simulates a merchant PayPal account. Personal Simulates the a shopper PayPal account. Both of these types of accounts can be created at the same time with your original PayPal 'Live' account at Login at with your 'Live' log-in information (Figure 7). Once logged in, click on Dashboard Under Sandbox, click on Accounts (Figure 8). PayPal automatically creates your frst Business test account by appending '-facilitator' to your . Also a Personal shopper account is created by appending '-buyer'. Set their passwords by clicking on Profle under the address and changing the password. You can also opt to create a brand new Business account if you want a custom naming (Figure 9). 10 / 20

11 Figure 7: Log in with your 'Live' PayPal credentials at developer.paypal.com. Once logged in, click on 'Dashboard'. igure 8: Go to Sandbox: Accounts -> Profle to view Sandbox Business/Personal information 11 / 20

12 igure 9: Set Sandbox Business account password for subsequent Adyen Test API user confguration 3.2. Confguring your PayPal Sandbox Business account A Business Sandbox account can be used in your Adyen Test merchant accounts for test payments. But before Adyen can link it to your test account, you need to confgure it's API user frst. This is done in a similar way to the 'Live' accounts, but only at a diferent URL and with a diferent API user: Log in to your PayPal account at (Figure 10). Ensure that you are using a Sandbox Business account for this. Click on Profle (Figure 11). Click on API Access under Account Information (Figure 12). Click the Grant API permission link (Figure 13). Enter the Third Party Permission Username as sell1_ _biz_api1.adyen.com and click the Lookup button (Figure 14). Select the following API Access Levels; a) Use Express Checkout to process payments. b) Issue a refund for a specifc transaction. c) Process your customers credit or debit card payments. d) Authorize and capture your PayPal transactions. e) Obtain information about a single transaction. f) Obtain authorization for pre-approved payments and initiate pre-approved transactions. 12 / 20

13 g) Generate consolidated reports for all accounts. (In some countries you might get the error: These features are not available in the country where you have your PayPal account. In that case, you can leave this feld unchecked.) h) Use Express Checkout to process mobile payments. (Not needed if you don't have plans to support mobile payments) Once done, click the 'Add' button (Figure 15). Submit a ticket via to provide us with the PayPal Sandbox Business address that you have confgured the API user for. Figure 10: Log in with your Sandbox Business credentials at sandbox.paypal.com 13 / 20

14 igure 11: Once logged into Sandbox with your Sandbox Business Account, go to Profle 14 / 20

15 Figure 12: Click on 'API Access'. (Only visible in Sandbox Business accounts) 15 / 20

16 Figure 13: Grant API permission 16 / 20

17 Figure 14: Look up Adyen's special Test API username 17 / 20

18 Figure 15: Give the required permissions to Adyen's Test API user and click 'Add' 18 / 20

19 3.3. Making test payments Adyen has a general PayPal test shopper and password, which can be found at This can be used in Adyen's Test environment for PayPal Sandbox payments. Alternatively, you can use the Sandbox Personal shopper addresses that you have found/created in PayPal's developer environment. Using your own Personal shopper allows you keep track of your test payments on a shopper level at sandbox.paypal.com. 4. 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 16). Figure 16: 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 ( 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 therefore 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 ofers 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. 5. Payment Completion When a shopper has completed the payment they are redirected to a default Adyen result page. More information about 19 / 20

20 the result page and payment completion can be found in the Adyen. PayPal has a specifc 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 ofer a shopper to try again. If the shopper succeeds to successfully complete their payment, you will receive a normal AUTHORISATION notifcation with the success feld 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 notifcation 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. 6. Shopper Statement Some acquirers, including PayPal, support a variable shopper statement. To submit a variable shopper statement you can set the shopperstatement feld in the payment request to further improve the shopper experience. More information about submitting the Shopper Statement Field can be found in the Adyen. If no shopperstatement is supplied PayPal will use the merchant reference as the text used for the statement. 7. 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. 20 / 20