← Integrations

Paddle

Available now Revenue

Imports Paddle Billing transactions with tax and fees split out, refunds and subscription status as revenue events.

What we pull

• transactions (totals, tax, fee, earnings)
• adjustments (refunds, chargebacks)
• subscriptions

Every record lands as a financial event with source_type, external_id (deduplicated on re-sync) and provenance. Mode: mock.

Signals and sync

• Webhooks deliver changes in real time; a scheduled sync fills gaps.
• Sync interval: every 15 minutes plus webhooks.
• Health signals: auth_expired, silent (no sync for over twice the interval), error. Each becomes an in-app notification for the owner and shows in Integrations.

Permissions and secrets

• API key (read)
• Notification (webhook) secret

Secrets are encrypted at rest (AES-256-GCM, per-owner) and never returned by the API; the panel shows only the last 4 characters and the date. Read-only keys wherever the provider offers them.

Availability

Live: connect it from the panel (Integrations → Connect).

Setup steps

Connect from the panel: Integrations → Connect, paste the key or authorize, pick the business the data belongs to. The first sync starts in the background.