Skip to main content
Manalens records each Paddle sale and refund from a signed webhook and links it to the player who paid. Revenue and attribution then show which channels bring paying players.

Connect Paddle

You need the owner or admin role and a verified MFA session.
1

Create the webhook endpoint

In Settings, Integrations, Paddle, click Create webhook endpoint.
2

Register it in Paddle

In Paddle, add a webhook endpoint with the URL from Manalens. Select the supported events.
3

Save the signing secret

Paste the Paddle webhook secret key into Webhook signing secret and click Save signing secret. Revenue ingestion starts.
4

Import history (optional)

Enter a Read API key with read access to transactions, adjustments and subscriptions, then import. Imports resume automatically and are reconciled daily.
Secrets and read keys are encrypted and never returned to the browser.

Supported events

transaction.completed, approved refund adjustment.created and adjustment.updated, and subscription.*. Each webhook is verified against its signature. Other event types are ignored. Use one of these:
  1. A user_id in the Paddle custom_data.
  2. An identify trait paddle_customer_id:
See link revenue to users for the rules.

Disconnect

In Settings, Integrations, Paddle, click Disconnect read API. This removes the read key and stops imports. The webhook and imported revenue stay. To stop new revenue, delete the webhook endpoint in Paddle.