PayPal
Connect your PayPal account to the platform and activate its payment methods.
Connect your PayPal business account to the platform so you can route payments to it. You need a live PayPal application, its client ID and secret, and a webhook that sends payment events to the platform.

Step 1: Open your PayPal business account
Make sure you have a PayPal business account, and that you have created an application and its credentials in the production environment of the PayPal developer dashboard.

You need three values for your contract:
| Credential | Where it comes from |
|---|---|
| Client ID | Step 2, in the details of your live application |
| Secret | Step 2, in the details of your live application |
| Webhook ID | Step 3, after you create the webhook |

Step 2: Get the client ID and secret
-
Open your list of live applications, on the Apps and Credentials tab.
-
On the production application you want to use, select the three-dot menu, then Edit.

-
Copy the Client ID and the Secret.

Step 3: Configure the webhook
-
On the Apps and Credentials tab, open your application with the three-dot menu, then Edit.
-
At the bottom of the page, select Add webhook.

-
Enter the webhook URL for each environment (sandbox and production).

-
Select these events: Checkout, Vault, Payments & Payouts.
-
Once the webhook is created, copy its Webhook ID.

Step 4: Add a contract to your Merchant Account
-
Log in to your Merchant Account.
-
Go to Store › Contracts and select + Create.
-
Select the Merchant Account you want to link to the contract.
-
In the provider drop-down list, select PayPal.
-
Select the settlement currency. The list shows only the currencies available for this provider.
-
Give the contract a name you will recognize, for example the provider name.
-
Enter the client ID and the secret you copied in step 2, and the webhook ID you copied in step 3.
-
Leave the operational configuration (authentication, risk assessment, network tokenization) unchanged.
-
Select your sales channels and add payment methods. For each payment method, you can set the authorization currency and the sales channels.
-
Optional: set up an exclusion rule. It defines a condition under which this contract is not used for routing.
-
Select Save, then Publish to make the contract operational.
Related pages
Updated 18 days ago