PayPal account setup

PayPal's online documentation provides clear descriptions and explanations about how to carry out these tasks:

Grant API permission

Grant API permissions to the Adyen API in your live PayPal account.

  • Credit payments to your PayPal account.
  • Provide access to extra reporting features.

To set up API permission, do the following:

  • Log in to your PayPal account.
  • Go to Profile > Account Settings.
  • In the My Profile window, select Selling preferences.
  • In the Selling online area, look for the API access row
  • Click the corresponding Update link.

  • In the API Access window, click the Grant API permission link.
  • In the Add New Third Party Permissions window, go to the Third Party Permission Username field, and enter the following username:

    Starting from 22 Nov 2016, use "" instead of "". If you were using "" before 22 Nov 2016, it was automatically updated by PayPal to "".

  1. Click Lookup to generate a list with the available permissions for the specified API.
  2. In the API permission list, select the following checkboxes:
    1. Use Express Checkout to process payments.
    2. Issue a refund for a specific transaction.
    3. Process your shopper's credit or debit card payments.
    4. Authorize and capture your PayPal transactions.
    5. Obtain information about a single transaction.
    6. Obtain authorization for pre-approved payments and initiate pre-approved transactions.
    7. Generate consolidated reports for all accounts.
      (In some countries, you might get an error message informing you that the feature is not available in the country where you have your PayPal account. In this case, uncheck/deselect this option.)
    8. Use Express Checkout to process mobile payments.
      (If you do not support or plan to support mobile payments, leave this option unchecked.)
  3. Click Add. 

  • After completing this task, contact our support team to notify the PayPal account email address you want to use for your PayPal payment integration.

Add recurring payment management

Follow the steps described in the third-party API permission setup section.

In the Available Permission list, select the following checkboxes:

  • Charge an existing customer based on a prior transaction.
  • Create and manage Recurring Payments.

After enabling recurring payments in your PayPal account, you can start executing recurring transactions programmatically through the Adyen payments platform by passing the recurringDetailReference parameter for each subsequent recurring transaction via the  API.

You can configure your PayPal account to remember how often a shopper should be charged (frequency options for recurring payments), without making API calls to the merchant each time it needs to check the value. For further details, refer to PayPal's Reference Transactions document. However, we do not recommend Adyen merchants to enable this feature because recurring transactions initiated by PayPal independent of the Adyen payments platform are not available in the Customer Area.


For using MASSPAY, you need to provide the following permissions additionally for the MassPay setup:

  • Obtain your PayPal account balance.
  • Initiate transactions to multiple recipients in a single batch.

Contact Support Team to know if this can be enabled for you.