This guide will help you set up the integration with Paypal Payouts API that will allow you to pay your affiliates quickly, in bulk, directly from FirstPromoter dashboard.
- A Paypal business account
- Payouts need to be enabled for your Paypal account. We'll show you below how to check and how to enable them.
- Be subscribed to FirstPromoter Business or Enterprise plans. On Starter plan and Free trial this feature is not available.
Go to Paypal Developers page and Log In to the developer dashboard by clicking the 'Log into dashboard' link from top-right side of the page.
Click on "My account" on the left and scroll down until you see the "Permissions" table. Check if on the last row "Payouts" you see a green checkmark on the Live column or "Enable" like in the screenshot below. If you see the "Enable" link, click on it. Usually they will ask you to contact Paypal and make a request to enable the Payouts API feature for your account.
Activating this feature may take from several hours to several days. You'll get an email once it's activated and you can login back to Paypal dashboard like in Step 1.
Click on "My Apps and Credentials" from the left menu. Next click on the "Live" button below "My Apps and Credentials" title on the right side then on the "Create app" button. On the 'App name' field you can enter "FirstPromoter payouts" and click again "Create app".
After the app is created you'll see the details required to connect FirstPromoter to Paypal.
Note: If you see "Live/Sandbox" on top right after creating the app, make sure "Live" is selected.
Copy the "Client ID" value and "Client secret" (click on 'Show' link below "Secret" label to view the client secret) and paste them to the corresponding fields on FirstPromoter's Paypal integration form. Once the Client ID and Client Secret is filled, copy the "Webhook Endpoint URL" field, you'll need to paste it later on Paypal Webhook Url. Do not click "Save" yet.
If you don't have Paypal integration setup open, log in to FirstPromoter, go to Payouts section > click "Configure Paypal payouts" > click "Integration setup" link from the top-right side.
For us to know when a payout is completed or failed, you need to connect Paypal webhooks with FirstPromoter.
Switching back to Paypal app, scroll down and click "Add webhook" button.
After you click "Add webhook", paste the "Webhook Endpoint URL" you copied previously on Step 5 to the "Webhook Url" field.
Next, scroll down and check all checkboxes that start with "Payment payouts-item" (there are 9 of them, all grouped together) and "Payment payoutsbatch denied" so 10 checked in total exactly like in the screenshot below.
Scroll down a bit more until you see the "Save" button and click it.
Copy the "Webhook ID" value after you added the webhook and paste it back on FirstPromoter Paypal integration form into the "Webhook ID" field. Click Save.
Step 8 (final step)
If the save is successful it means we could connect to Paypal API correctly and the API connection is working.
You'll get redirected back to "Configure Paypal payouts" panel where you need to click the switch to enable direct payments. Follow the on screen instructions to set up the security token and save the form.