Connect Paddle Billing
In the client’s workspace, open Sources, add Paddle Billing and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.
Billing & revenue integration
Turn paddle Billing metrics, customers, catalog, subscriptions, transactions, and adjustments into 89 governed metrics for dashboards, agent answers, and cross-channel reporting.
What you can do with Paddle Billing in Maven
Maven models Paddle Billing into 89 governed metrics from the semantic layer. Track Active Subscribers, Chargeback Count, Completed Checkouts, Historical MRR and Current MRR, break results down by Is Latest Snapshot, Account, Item Index and Customer Name, and report Paddle Billing alongside HubSpot CRM, Shopify and Google Analytics 4 without rebuilding exports or metric logic for every report.
What you can measure
Maven keeps Paddle Billing numbers consistent across dashboards, reports, and answers so the team is not debating which spreadsheet is right.
Paying users with active subscriptions reported by Paddle; excludes trialing users
Chargebacks received excluding alerts and reversals
Paddle checkouts that completed a successful payment
Official historical daily monthly recurring revenue reported by Paddle Billing
Latest monthly recurring revenue snapshot per platform, account, and currency. Stripe includes active and past-due fixed recurring items normalized monthly; excludes trials, free prices, metered usage, taxes, and one-time charges. Discounts are not yet netted from Stripe item prices.
Paddle MRR change compared with the same interval one month earlier
Completed Paddle checkouts divided by all checkouts
Checkouts opened during the selected period
Latest active subscription count per platform account and currency across connected billing platforms
Paddle completed-payment revenue after tax and fees and before refunds or chargebacks
Latest subscribed seat or unit quantity per platform account and currency
Paddle refunded product subtotal excluding chargebacks
Completed transactions represented in Paddle net revenue
Checkouts opened during the selected period (Paddle today)
Current subscription item count
Current fixed recurring amount normalized monthly at subscription-item grain
Current subscription item quantity
Recurring charges at charge grain across connected billing platforms
Discount applied to the recurring charge.
Total recurring charge amount.
Shipping charged on the recurring charge.
Charge subtotal before tax, shipping, and discounts.
Tax charged on the recurring charge.
Payment amount applied to linked invoices
QuickBooks-canonical cash collected from payments (payments union is QB-first)
Gross payment amount. Filter by direction: in is cash received from customers, out is cash paid to vendors.
Number of payment-to-document applications.
Amount of payments applied to invoices (direction in) or bills (direction out).
Number of payments.
Payment amount net of fees and refunds.
Amount refunded on payments.
Rows on the merged payments surface (payment and application rows). Canonical measure; filter by direction and payment_row_type.
Successful payment amount less refunds
Refunded amount on payment headers
Cash paid to vendors on QuickBooks bill-payment headers
Bill-payment amount allocated to linked QuickBooks bills
Count of current QuickBooks bill payments
Amount on current QuickBooks bill item/account lines
Count of current QuickBooks bill item/account lines
Quantity on current QuickBooks item-based bill lines
Approved chargebacks allocated to billing lines
Approved chargeback reversals allocated to billing lines
Approved credits allocated to billing lines
Discount allocated to billing transaction lines
Billing line total less approved refunds credits and chargebacks plus reversals
Approved refunds allocated to billing lines
Billing line subtotal before discount and tax
Tax allocated to billing transaction lines
Billing line total after discount and tax before adjustments
Calculated Paddle transaction line count
Quantity sold on calculated Paddle transaction lines
Line amount across invoice, bill and billing transaction lines. Filter by direction (AR/AP) and line_source.
Approved chargebacks allocated to billing lines. Canonical measure; filter by document_source / line_source / direction for one source.
Approved chargeback reversals allocated to billing lines. Canonical measure; filter by document_source / line_source / direction for one source.
Number of finance document lines.
Approved credits allocated to billing lines. Canonical measure; filter by document_source / line_source / direction for one source.
Discount on finance document lines.
Billing line total less approved refunds credits and chargebacks plus reversals. Canonical measure; filter by document_source / line_source / direction for one source.
Quantity on finance document lines.
Approved refunds allocated to billing lines. Canonical measure; filter by document_source / line_source / direction for one source.
Rows on the merged document-lines surface. Canonical measure; filter by line_source for one source.
Billing line subtotal before discount and tax. Canonical measure; filter by document_source / line_source / direction for one source.
Tax on finance document lines.
Revenue amount on current QuickBooks sales-item invoice lines
Count of current QuickBooks sales-item invoice lines
Discounts allocated to current invoice lines
Quantity sold on current QuickBooks sales-item invoice lines
Tax allocated to current invoice lines
Customers with starting MRR and zero ending MRR
Starting MRR lost from customers ending the month inactive
Negative MRR movement among customers that remain active
Customers with positive MRR at the end of the month
MRR at the end of the month; group or filter by currency and inspect history_method
Positive MRR movement among existing customers
Recurring revenue retained before expansion and reactivation
Share of starting subscriber logos that churned during the month
MRR from customers first active in the month
Net recurring revenue retained including expansion and reactivation
MRR from customers returning after an inactive month
Customers with positive MRR at the start of the month
MRR at the start of the month; group or filter by currency and inspect history_method
Monthly QuickBooks-canonical cash collected for workspace profitability
Monthly delivery billable amount from time tracking
Monthly delivery cost from time tracking
As-of-today open AR snapshot attributed to the current month only (not historical month-end AR)
Monthly operating expenses for workspace profitability
Monthly canonical invoice revenue for workspace profitability
Questions you can ask
Maven’s agent answers in plain language with the right metric definitions applied automatically. These are real, verified questions it can run today.
What is our current MRR?
Connection and sync
You connect Paddle Billing with API credentials from the Paddle Billing account. Maven stores them encrypted. The first Paddle Billing sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 3 years in total. After that, each scheduled sync re-reads the last 7 days, so late changes are picked up.
Maven connection scope plus Paddle seller and primary balance currency context.
Fields: account name, primary balance currency, environment, livemode
Official daily Paddle Billing metrics that replace the legacy ProfitWell metrics adapter.
Fields: account name, currency, active subscribers, checkout count, completed checkout count, checkout conversion rate, mrr, mrr change, net revenue, transaction count, and 3 more
Account-scoped active and archived Paddle customer dimensions.
Fields: customer name, customer email, customer email hash, locale, marketing consent, status, custom data json, created at, updated at, account name, and 1 more
Account-scoped active and archived Paddle product catalog.
Fields: product name, description, product type, tax category, status, custom data json, created at, updated at, account name, source version at
Account-scoped active and archived Paddle one-time and recurring prices.
Fields: price name, description, price type, billing cycle interval, billing cycle frequency, trial interval, trial frequency, trial requires payment method, tax mode, unit amount minor, and 11 more
Current account-scoped Paddle subscription lifecycle and hierarchy.
Fields: status, collection mode, currency, billing cycle interval, billing cycle frequency, current period start, current period end, first billed at, next billed at, paused at, and 10 more
Current Paddle subscription item hierarchy at price grain.
Fields: item index, item status, quantity, recurring at, billing cycle interval, billing cycle frequency, unit amount minor, unit amount, currency, created at, and 3 more
Account-scoped billing transaction headers with source-of-truth totals and payout economics.
Fields: customer name, business name, customer country, invoice number, status, origin, collection mode, currency, subtotal minor, discount minor, and 28 more
Calculated transaction line items with product, price, quantity, discount, tax, and proration.
Fields: item index, product name, product type, tax category, quantity, tax rate, proration rate, billing period start, billing period end, unit subtotal, and 10 more
Credits, refunds, chargebacks, and chargeback reversals against Paddle transactions.
Fields: action, adjustment type, status, reason, currency, subtotal, tax, total, fee, retained fee, and 10 more
Adjustment allocation to calculated Paddle transaction line items.
Fields: item index, adjustment item type, amount, subtotal, tax, total, currency, account name, source version at
How it works
No SQL or warehouse setup. Connect the source, then build the client’s report by asking Claude or ChatGPT.
In the client’s workspace, open Sources, add Paddle Billing and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.
Maven pulls the client’s Paddle Billing data (11 objects) and models it into documented tables. No SQL, warehouse or pipeline setup.
Build the client’s report or deck by asking Claude or ChatGPT through the MCP, set alerts on what matters, and publish to the client’s portal once you approve it.
Works well with
FAQ
Maven exposes 89 governed Paddle Billing metrics, including Active Subscribers, Chargeback Count, Completed Checkouts, Historical MRR, Current MRR and MRR Change — each defined once so it means the same thing in every report.
You can break Paddle Billing metrics down by Is Latest Snapshot, Account, Item Index, Customer Name, Subscription Status, Collection Method, Current Period Start and Current Period End, and more.
Yes. Paddle Billing sits in the same client workspace as sources like HubSpot, Shopify, Google Analytics 4 and Google Ads, so one report or question can use them together.
Maven syncs paddle seller and primary balance currency context, official daily Paddle Billing / ProfitWell metrics, active and archived billing customers, active and archived product catalog, one-time and recurring billing prices and subscription lifecycle and billing hierarchy, and more from Paddle Billing.
Maven refreshes Paddle Billing on a schedule after the source is connected, and shows each source’s last sync time in the client’s workspace, so you can check the data is current before a report goes out.
Yes. Maven encrypts integration credentials and tokens, scopes access to the workspace, and uses the connection only to sync the reporting data needed for governed analytics.
Set up your first client, build their report by asking Claude or ChatGPT, and publish it to their portal.
Nothing is charged unless you subscribe.