All Collections
Settings
How to enroll in PayPal Payouts API
How to enroll in PayPal Payouts API
Steps to enroll in PayPal payouts
Tim Nixon avatar
Written by Tim Nixon
Updated over a week ago

Requirements to use PayPal Payouts 

  1. Please contact PayPal to ensure that Payouts has been enabled for your account. Not all PayPal accounts have this feature enabled automatically.

If you are switching from PayPal Mass Payments, then you should remove your IPN notification in PayPal. You can find the instructions to do that listed here

Set up

Step 1 

Head over to PayPal's Developer portal and click on Developer Dashboard in the dropdown located in the top right corner of the screen. You may be asked to login first.

Step 2

You need to verify that you have the Payouts API enabled. Unfortunately, this might take anywhere from a few hours to several days for PayPal to give you permission. We don't have control over this. However, applying for it is very easy.

At the bottom of the column called "permission name", you'll see the row labeled "Payouts". You want to click the "Enable" link. 

PayPal will email you that they are reviewing your request. Once you've been accepted you'll notice a green checkmark signifying that the API is live.

Step 3

Click on Apps & Credentials in the main menu. Under REST API apps. Click the "Create App" button.


Step 4

(Create a name for your App) Under App Name type "Trolley". Then click the "Create App" button.

Step 5

Click Show underneath the Secret header and make sure to select "Live" on the top right.

Step 6

Please make note of the two fields marked Client ID and Secret. You'll need to input these into your Trolley account in the next section

We recommend opening up a text editor like Notepad or a Google Doc and copying and pasting those IDs to reference later in this article.

Step 7 

Scroll down from LIVE API CREDENTIALS to LIVE APP SETTINGS and see if you have given application Payouts and Transaction Search options.

We do recommend leaving other options as they were.

Step 8

Now we need to obtain the Webhook ID. The Webhook ID allows us to keep track of your payment statuses inside Trolley.

We need to do three things to generate the ID. First, scroll down to "Add Webhook" button in the Live Webhooks box.

Second, enter the following URL in the "Webhook URL" field: https://api.paymentrails.com/hook/paypal/app

Lastly, click the box labelled "all events". When you click it, all the boxes will become checked. Scroll down and click save.

Please note: The following steps can only be completed after PayPal has approved your access to their Payouts API

Step 9

You should now be able to view your Webhook ID. Make note of this ID, you'll need it in the steps below.

Please note: The following steps can only be completed after PayPal has approved your access to their Payouts API

By default, the Payouts feature is enabled in the sandbox environment. Merchants in the U.S. with a business account can enable Payouts in the live environment.

Note: Merchants in other countries must contact PayPal to enable Payouts in the live environment.

Step 10

Now you must input the details in your Trolley account. In the dashboard go to Settings > Payout Method and select the PayPal icon.

Step 11

In the top section of the PayPal set-up page, select the Payouts REST API radio button (under PayPal Payment Solution):

Step 12

Further down the page under REST API App Credentials, copy over the API credentials that you noted down from your PayPal account. Enter the PayPal credentials into the corresponding fields, and then make sure to save them by clicking on Save REST API App Credentials at the bottom:

Step 13

Now enable PayPal as a Payout Method - switch the toggle in the top-right corner of the page from DISABLED (gray) to ENABLED (green):

With PayPal now enabled in your Trolley account, your recipients can select PayPal as their Payout Method, and you will be able to create and send their PayPal payments from within Trolley. Your PayPal account balance will also appear in the Balances page of your Trolley Dashboard.


Please note that you still need to fund your PayPal account in order to send PayPal payouts, as we do not touch those funds (or charge any extra fees). We simply allow you to send PayPal payouts in addition to Bank Transfer payouts, all through one single integration with Trolley.

For more details on the difference between PayPal Payouts API and PayPal Mass Payments, please see What is the PayPal Payouts API

Did this answer your question?