PayPal is a supported payment method for marketplaces, but note that certain requirements and limitations apply. To enable your marketplace users to accept online PayPal payments, you need to:
Get a PayPal marketplace account and give Adyen access to that account.
Adyen will add and configure PayPal as a payment method in your Customer Area.
Integrate PayPal in your online payments flow.
When you go live, create a live PayPal business account and a live PayPal marketplace account.
Requirements and limitations
To support PayPal payments:
- You must have a marketplace setup in your Adyen for Platforms integration.
PayPal is not supported in a classic platforms integration.
The supported currencies for PayPal payments are:
Step 1: Create developer and sandbox accounts
To test your integration, you need to create a PayPal developer account and PayPal personal and business sandbox accounts.
Create a PayPal developer account, if you don't already have one.
This account gives access to the developer dashboard where you can create and manage business and personal sandbox accounts.
Under your developer account, create a PayPal business sandbox account.
This account, ending in @business.example.com for example, lets you simulate the merchant's role when testing payments.
Under your developer account, create a PayPal personal sandbox account.
This account, ending in @personal.example.com for example, lets you simulate the customer's role when testing payments.
Step 2: Set up a PayPal marketplace account
You need to create a PayPal marketplace account and give Adyen permission to access that account so that we can connect it to your Adyen integration.
Ask your Adyen contact to ensure PayPal sends you the details of your PayPal marketplace account.
When you have your PayPal marketplace account, ask your Adyen contact for a referral URL.
Using the referral URL, log in to your PayPal marketplace account and confirm you give Adyen permission to access this account.
Step 3: Integrate PayPal payments
When your Adyen contact has informed you that we have completed configuring PayPal in your Customer Area:
- Ask your PayPal account manager what PayPal risk data you must provide.
- Build your PayPal integration including:
- Split payment data.
paypalRiskfields that PayPal told you to include. For instructions, see the PayPal page for your integration type.
Add PayPal to your existing Web Drop-in integration.
Add PayPal to your existing Web Components integration.
Test and go live
Test your integration
When you are done setting up your integration, use your PayPal sandbox accounts to test the PayPal payment flow. Your business sandbox account lets you simulate your role as a merchant when testing payments. With your personal sandbox account you can simulate the role of a customer.
For more information, see the PayPal sandbox testing guide.
You can check the status of a PayPal test payment in your Customer Area > Transactions > Payments.
Before you go live
For live operations, you need to set up a live PayPal business account and a live PayPal marketplace account.
Create a live PayPal business account:
Go to the PayPal website, select Sign Up, and follow the instructions.
Don't use a personal email address for your live PayPal business account. We strongly recommend that you use a generic company email address. This is to prevent having to configure a new account for your business in the future, should the personal email address no longer be in use for any reason. The email address for your live PayPal business account will also be shown on the payment receipt the customer receives from PayPal.
Activate your business account.
Create a live PayPal marketplace account:
- Ask your Adyen contact to ensure PayPal sends you the details of your PayPal marketplace account.
- When you have your PayPal marketplace account, ask your Adyen contact for a referral URL.
- Using the referral URL, log in to your PayPal marketplace account and confirm you give Adyen permission to access this account.
Adyen will add and configure PayPal as a payment method in your live Customer Area.