Paddle

Stable

Paddle on WhatsApp — subscription events, MRR, churn alerts, and tax compliance from chat

Payments & Billing

What is Paddle?

Paddle is a merchant of record for SaaS and digital products, handling subscriptions, global payments, sales tax, and VAT compliance for companies like Unity, Rocket.Chat, and thousands of indie SaaS. The LunoGen Paddle integration uses Paddle Billing (v2) webhooks and API so your AI agent can react to every subscription event and deliver revenue and compliance insights on WhatsApp.

Why connect Paddle?

If Paddle is your billing stack, your revenue story lives in Webhooks and Notification settings. The problem: the native dashboard is light on proactive alerts, and most founders only learn about churn when the MRR chart dips. LunoGen sits on the webhook stream, pings you on churn the instant it happens, tracks MRR day-over-day, and does the boring tax compliance paperwork in the background.

What you can do

  • Real-time subscription event webhooks (created, updated, cancelled, paused)
  • Transaction completed and failed notifications
  • MRR, ARR, and net revenue retention tracking
  • Churn alerts with customer context and retention suggestions
  • Tax compliance summaries (VAT, GST, US sales tax collected)
  • Customer lifecycle events (trial started, trial ended, upgraded, downgraded)
  • Dunning failure alerts with recovery suggestions
  • Product catalog and price list management
  • Refund processing through Paddle API
  • Monthly revenue report with currency and geo breakdown
  • Works with Paddle Billing (v2) and the legacy Classic API

Setup

Requirements

  • A Paddle Billing (v2) account
  • Permissions to generate an API key in Paddle
  • A LunoGen account with the Pro plan or higher
  1. 1

    Generate a Paddle API key

    In the Paddle dashboard go to Developer Tools → Authentication → New API key. Name it 'LunoGen Agent' and copy the key. LunoGen only needs read access for most use cases — grant write only for refund and subscription management use cases.

  2. 2

    Connect the account in LunoGen

    Open Credentials → New → Paddle, paste the API key, and select your environment (sandbox or live). LunoGen verifies the key by calling /businesses.

  3. 3

    Set up a notification destination

    In Paddle go to Developer Tools → Notifications → New destination. Paste the LunoGen webhook URL, choose 'webhook', and subscribe to subscription.created, subscription.updated, subscription.canceled, transaction.completed, and transaction.payment_failed.

  4. 4

    Configure MRR baseline

    On first connect LunoGen pulls the last 90 days of transactions and stores a baseline MRR in memory. This is used for day-over-day comparisons in the morning dashboard.

Paddle use cases

6 total

Paddle Subscription Event Alerts on WhatsApp

Every subscription.created and subscription.updated event from Paddle triggers the agent. It fetches the customer and price details, and posts a clean notification to your revenue WhatsApp group.

Webhook + WhatsApp Groupwebhooksubscriptionsnotifications
Webhook received: subscription.created — sub_01HXY2Z3P (Team Annual)
http_request → Paddle API

Paddle subscription.created webhook fired. Pulling customer, address, and price details...

See full conversation

Paddle Churn Alerts with Retention Suggestions

Every subscription.canceled event pings the agent. It looks up the customer's lifetime value, tenure, and plan, then suggests a retention play — a call, a discount, or a graceful goodbye depending on the account's size.

Webhook + WhatsApp DMchurnretentionwebhook
Webhook received: subscription.canceled — sub_01HWPQ9 (Team Monthly)
http_request → Paddle API

Churn event. Pulling customer history, LTV, and exit reason from /customers and /subscriptions...

See full conversation

Paddle Tax Compliance Summary on WhatsApp

Because Paddle is your merchant of record, they handle the tax — but you still need visibility. Each month the agent pulls tax-by-jurisdiction numbers and delivers a clean VAT/GST/US sales tax summary for your accountant.

Cron + WhatsApp DMtaxcompliancereporting
Cron triggered: Paddle monthly tax summary (1st at 9:00 AM)
http_request → Paddle API

Pulling March transactions and tax breakdown via /transactions?include=adjustments,totals...

See full conversation

Related integrations

Ready to connect Paddle?

Spin up an AI agent in under 2 minutes, plug in your Paddle credentials, and start running your workflows from WhatsApp.