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:

CredentialWhere it comes from
Client IDStep 2, in the details of your live application
SecretStep 2, in the details of your live application
Webhook IDStep 3, after you create the webhook

Step 2: Get the client ID and secret

  1. Open your list of live applications, on the Apps and Credentials tab.

  2. On the production application you want to use, select the three-dot menu, then Edit.

  3. Copy the Client ID and the Secret.

Step 3: Configure the webhook

  1. On the Apps and Credentials tab, open your application with the three-dot menu, then Edit.

  2. At the bottom of the page, select Add webhook.

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

  4. Select these events: Checkout, Vault, Payments & Payouts.

  5. Once the webhook is created, copy its Webhook ID.

Step 4: Add a contract to your Merchant Account

  1. Log in to your Merchant Account.

  2. Go to Store › Contracts and select + Create.

  3. Select the Merchant Account you want to link to the contract.

  4. In the provider drop-down list, select PayPal.

  5. Select the settlement currency. The list shows only the currencies available for this provider.

  6. Give the contract a name you will recognize, for example the provider name.

  7. Enter the client ID and the secret you copied in step 2, and the webhook ID you copied in step 3.

  8. Leave the operational configuration (authentication, risk assessment, network tokenization) unchanged.

  9. Select your sales channels and add payment methods. For each payment method, you can set the authorization currency and the sales channels.

  10. Optional: set up an exclusion rule. It defines a condition under which this contract is not used for routing.

  11. Select Save, then Publish to make the contract operational.

Related pages