Payment-method icon

Set up PayPal

Create a PayPal environment and add PayPal to your Customer Area.

If you are a marketplace, follow the PayPal setup instructions for marketplaces.

To enable test PayPal payments, you need to:

  1. Create PayPal sandbox accounts.
  2. Set up PayPal in your test Customer Area.
    We will send you an activation link.
  3. Use your activation link to give Adyen permission to process transactions on your PayPal business sandbox account.

When you go live, you need to:

  1. Create a live PayPal business account.
  2. Set up PayPal in your live Customer Area.
    We will send you an activation link
  3. Use your activation link to give Adyen permission to process transactions on your live PayPal business account.

Create PayPal sandbox accounts

To test your integration, you need to have three PayPal accounts:

  • A PayPal developer account.
  • A PayPal business sandbox account.
  • A PayPal personal sandbox account.

To be able to see your test payments later, it is important that you create your sandbox accounts under your PayPal developer account.

  1. Create a PayPal developer account, if you don't already have one.
    In your test Customer Area, you will need to provide the email address associated with your PayPal developer account. This account gives access to the developer dashboard where you can create and manage PayPal business and personal sandbox accounts.

  2. Under your PayPal developer account, create a PayPal business sandbox account.
    This account lets you simulate receiving payments as a merchant when testing payments.

  3. Under your PayPal developer account, create a PayPal personal sandbox account.
    This account lets you simulate making payments as a shopper when testing payments.

Add PayPal to your Customer Area

When you add PayPal to your test or live Customer Area, you need to provide some details specifically for PayPal.

When you add PayPal as a payment method to your test Customer Area:

  • Specify the email address that you use when logging in to your PayPal developer account.
  • Skip the Merchant ID field.
  • By default, PayPal payments are captured immediately after authorisation. If you want to capture payments later, select Enable authorisation & capture.

In your Customer Area, PayPal is now marked as Waiting for PayPal approval.

Give Adyen permission

You need to inform PayPal that you allow Adyen to process transactions on your PayPal account. To enable you to do that, we send you an email with an activation link as soon you have added PayPal in your Customer Area.

  • For test, you receive the activation link on the email address that you use when logging in to your PayPal developer account.
  • For live, you receive the activation link on the email address that you specify when creating your live PayPal business account.
  • You can also get the link from your test Customer Area or live Customer Area > Settings > Payment methods: select PayPal and in the details pane find the link under Acquirer account, in the MID field.

When you receive the email:

  1. Open the activation link.
  2. Log in to the PayPal business account that is associated with the email address.
  3. Accept all permissions that Adyen is asking for.

After a few minutes, the status of PayPal in your Customer Area will change to Active. If this doesn't happen, ask our Support Team to set PayPal to Active manually.

Create a live PayPal business account

For live operations, you need to set up a live PayPal business account:

  1. Go to the PayPal website, select Sign Up, and follow the instructions.

    Do not use a personal email address for your live PayPal business account. We strongly recommend that you use a generic company email address. This prevents having to configure a new account for your business in the future, if the personal email address is 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 shopper receives from PayPal.

  2. Activate your business account.

  3. Make a note of the email address associated with this PayPal account, because you need to provide the address in your live Customer Area.

Don't forget that to go live, you also need to:

  1. Set up PayPal in your live Customer Area.
  2. Open the activation link and give Adyen permission to process transactions on your live PayPal business account.

Fallback

It is possible that an error occurs, and you don't receive the email with the activation link. When this happens, you need to set up PayPal manually.