UseLoyaltyPayments Integration
Paddle
Reward subscriptions and one-time purchases processed through Paddle.
About this integration
Paddle + UseLoyalty
Paddle acts as a merchant of record for SaaS, digital products, and subscription businesses. Wiring Paddle webhooks into UseLoyalty means every completed transaction automatically drives loyalty — subscriptions, upgrades, one-time purchases, and renewals.
Webhook endpoint
Configured in UseLoyalty dashboard
https://app.useloyalty.app/api/webhooks/paddle/{program-id}
This URL is generated for your account in the UseLoyalty dashboard. Each integration has its own signed endpoint.
Setup guide
Connect Paddle in minutes.
Follow the steps below to wire Paddle webhooks into your UseLoyalty program. No code required.
Copy your webhook endpoint URL
Go to UseLoyalty Dashboard → Settings → Integrations → Paddle. Copy the endpoint URL shown. It follows the format https://app.useloyalty.app/api/webhooks/paddle/{your-program-id}.
Open Paddle Developer Tools
Log into vendors.paddle.com → Developer Tools → Notifications. Click New Destination and select Webhook as the type.
Configure the webhook destination
Paste the UseLoyalty endpoint URL, give it a description (e.g. UseLoyalty), and select the events listed in the Events section below.
Copy the webhook secret key
Paddle generates a secret key for the destination. Copy it and paste it into UseLoyalty Dashboard → Settings → Integrations → Paddle → Webhook Secret. UseLoyalty uses this to verify HMAC signatures on every incoming event.
Test with Paddle's sandbox
Switch to your Paddle Sandbox account, complete a test transaction, and confirm the event arrives in UseLoyalty's activity log before going live.
Map events to loyalty rules
In the UseLoyalty campaign builder, create rules that fire on Paddle transaction.completed or subscription.activated events. Set points, limits, and reward eligibility.
Webhook events
Events to subscribe to.
Subscribe to these events in your Paddle dashboard when creating the webhook. UseLoyalty maps each event to your campaign rules automatically.
transaction.completedFires when a Paddle transaction is fully paid. Core trigger for purchase points.
subscription.activatedFires when a new subscription becomes active after first payment.
subscription.renewedFires on each successful subscription renewal cycle.
subscription.updatedFires when a subscription plan or quantity changes — useful for tier adjustments.
transaction.refundedFires when a transaction is refunded. Use to deduct points if configured.
Get a tailored walkthrough
Ready to build
loyal customers?
Tell us a bit about your paddle loyalty program and we'll show you exactly how UseLoyalty can work for you.
- Live demo tailored to your paddle loyalty program
- Setup walkthrough, live in under 10 minutes
- Pricing advice based on your location count
FAQ