All integrations
PA

Payments Integration

PayPal

Trigger points and rewards automatically on PayPal payments and orders.

About this integration

PayPal + UseLoyalty

PayPal is one of the world's largest payment networks. Connecting PayPal webhooks to UseLoyalty lets you reward customers for every completed payment, whether they pay via PayPal balance, card, or Buy Now Pay Later — without polling the PayPal API.

Webhook endpoint

Configured in UseLoyalty dashboard

https://app.useloyalty.app/api/webhooks/paypal/{program-id}

This URL is generated for your account in the UseLoyalty dashboard. Each integration has its own signed endpoint.

Setup guide

Connect PayPal in minutes.

Follow the steps below to wire PayPal webhooks into your UseLoyalty program. No code required.

1

Copy your webhook endpoint URL

Open UseLoyalty Dashboard → Settings → Integrations → PayPal. Copy the webhook endpoint URL (e.g. https://app.useloyalty.app/api/webhooks/paypal/{your-program-id}).

2

Open the PayPal Developer Dashboard

Go to developer.paypal.com → My Apps & Credentials. Select your app (or create one). Scroll to Webhooks and click Add Webhook.

3

Paste the endpoint and select events

Enter your UseLoyalty webhook URL. Tick the events listed in the Events section below. Save the webhook.

4

Copy the Webhook ID

PayPal shows a Webhook ID after saving. Copy it and paste it into UseLoyalty Dashboard → Settings → Integrations → PayPal → Webhook ID. UseLoyalty uses this to verify event signatures.

5

Add your PayPal Client ID and Secret

Still in the UseLoyalty integration settings, add your PayPal App Client ID and Client Secret. These allow UseLoyalty to verify webhook signatures using PayPal's verification API.

6

Send a test event

Use the PayPal webhook simulator (Developer Dashboard → Webhooks → Simulate) to fire a PAYMENT.CAPTURE.COMPLETED event and confirm it appears in UseLoyalty activity.

Webhook events

Events to subscribe to.

Subscribe to these events in your PayPal dashboard when creating the webhook. UseLoyalty maps each event to your campaign rules automatically.

PAYMENT.CAPTURE.COMPLETED

Fires when a payment capture succeeds. Primary trigger for purchase points.

CHECKOUT.ORDER.COMPLETED

Fires when a buyer completes a checkout order.

PAYMENT.SALE.COMPLETED

Fires on completed sale payments in older PayPal integrations.

BILLING.SUBSCRIPTION.CREATED

Fires when a new PayPal subscription is activated.

BILLING.SUBSCRIPTION.RENEWED

Fires on subscription renewal — reward recurring customers.

Get a tailored walkthrough

Ready to build
loyal customers?

Tell us a bit about your paypal loyalty program and we'll show you exactly how UseLoyalty can work for you.

  • Live demo tailored to your paypal loyalty program
  • Setup walkthrough, live in under 10 minutes
  • Pricing advice based on your location count

FAQ

Common questions