Paypal Disputes Webhook

This guide details the process in your Paypal account to enable Forter to receive automatic notifications of chargebacks via webhooks. This configuration will streamline the process of chargeback submissions to Forter, ensures Forter’s real-time decisions are based on the latest chargeback data (enhancing Forter’s accuracy), and prevents unnecessary delays in the reimbursement of chargebacks covered by Forter’s Chargeback Guarantee.

Step 1: Log into the Paypal Developer Portal
Log into the Paypal Developer portal: https://developer.paypal.com

Step 2: Go to your Paypal API Application
Once you have logged in, on the top bar next to Home, select Apps & Credentials.

On the Apps & Credentials page, select Live for the toggle located on the top right of the page. Look in the REST API apps selection and, and select an existing app to use (if present) and continue to step a. If you do NOT see any apps in the REST API apps section, please check to see if your Paypal app is configured as a NVP/SOAP API app and once confirmed, continue to step b.

Note: A Paypal app should have been created when you configured Paypal as a payment method on your checkout page and you should NOT create a dedicated app specifically for Forter

a. REST API Apps Webhook Configuration
Click on the configured REST API app and you should see a screen similar to below with the title of your REST API app (In this example, the app is called Merchant_App). Copy the Client ID value and the Secret Key values to send to Forter in Step 5.

Scroll to the bottom of this page and you will see the Live Webhooks section. Click the “Add Webhook” button to setup the Forter claims webhook.

Continue to Step 3 to configure the Paypal webhook.

b. NVP/SOAP API Apps Webhook Configuration
Click on Manage Webhooks and you should see a screen similar to below with the title NVP SOAP Webhooks. Copy the Client ID value and the Secret Key values to send to Forter in Step 5.

Scroll to the bottom of this page and you will see the Live Webhooks section. Click the “Add Webhook” button to setup the Forter claims webhook.

Step 3: Configure the Paypal Webhook
Clicking the Add Webhook Button will generate a popup that looks like the below image

In the Webhook URL input, enter the following URL: https://api.forter-secure.com/webhooks/paypal/

Your Forter site id can be found in the API Reference section of the Forter portal. of the Forter portal.

Please make sure to add the siteId that corresponds to the Production Forter tenant.

Then from the list of events select: Customer Dispute which will add the below 3 fields. The webhook will fire and notify when any of these 3 events are triggered.

Customer dispute created

Customer dispute resolved

Customer dispute updated

At the bottom of the section, click Save.

Step 4: Copy Webhook ID
You should now see a new webhook configuration. Please copy the Webhook ID. Forter will also use this value to authenticate the Paypal webhooks.

Step 5: Send Credentials to Forter
Please copy and paste your Client ID, Secret (From Step 2), and Webhook ID (From Step 4) to a .txt file. Ensure the credentials are saved under the file naming convention "JCBR-merchantName-processorName" where processorName is a placeholder for which process these keys are for (ex. "JCBR-merchantName-Paypal") and upload it to your secure Forter S3. Instructions for accessing your S3 can be found at the bottom of the Historical Data Transfer Page. Please notify your Forter Project manager once these credentials have been uploaded.

Step 6: Use the Paypal Webhook Tester
Once the webhook is configured, use the Paypal Webhook simulator in the Developer Dashboard to confirm connectivity to Forter by entering the Webhook URL configured in step 3 and select “Dispute created” for the Event Type. A Forter representative can confirm connectivity to Forter to ensure that the webhook was configured with the correct Webhook URL.