Integrations

Paddle Billing datasets and fields

The 11 datasets Maven lands from Paddle Billing, every field in them, and how the connection syncs.

Maven lands 11 datasets from Paddle Billing in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the Paddle Billing integration page.

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.

Datasets#

Accounts#

Maven connection scope plus Paddle seller and primary balance currency context.

FieldType
account IDText
account nameText
seller IDText
primary balance currencyText
environmentText
livemodeTrue/false

Metrics#

FieldType
dateDate
account IDText
account nameText
currencyText
active subscribersInteger
checkout countInteger
completed checkout countInteger
checkout conversion rateNumber
mrrNumber
mrr changeNumber
net revenueNumber
transaction countInteger
refund amountNumber
chargeback countInteger
metrics updated atTimestamp

Customers#

Account-scoped active and archived Paddle customer dimensions.

FieldType
customer IDText
seller IDText
customer nameText
customer emailText
customer email hashText
localeText
marketing consentTrue/false
statusText
custom data jsonText
created atTimestamp
updated atTimestamp
account IDText
account nameText
source version atTimestamp

Products#

Account-scoped active and archived Paddle product catalog.

FieldType
product IDText
seller IDText
product nameText
descriptionText
product typeText
tax categoryText
statusText
custom data jsonText
created atTimestamp
updated atTimestamp
account IDText
account nameText
source version atTimestamp

Prices#

Account-scoped active and archived Paddle one-time and recurring prices.

FieldType
price IDText
product IDText
seller IDText
price nameText
descriptionText
price typeText
billing cycle intervalText
billing cycle frequencyInteger
trial intervalText
trial frequencyInteger
trial requires payment methodTrue/false
tax modeText
unit amount minorInteger
unit amountNumber
currencyText
quantity minimumInteger
quantity maximumInteger
statusText
custom data jsonText
unit price overrides jsonText
created atTimestamp
updated atTimestamp
account IDText
account nameText
source version atTimestamp

Subscriptions#

Current account-scoped Paddle subscription lifecycle and hierarchy.

FieldType
subscription IDText
seller IDText
customer IDText
address IDText
business IDText
discount IDText
statusText
collection modeText
currencyText
billing cycle intervalText
billing cycle frequencyInteger
current period startTimestamp
current period endTimestamp
first billed atTimestamp
next billed atTimestamp
paused atTimestamp
canceled atTimestamp
scheduled change actionText
scheduled change effective atTimestamp
scheduled change resume atTimestamp
item countInteger
custom data jsonText
created atTimestamp
updated atTimestamp
account IDText
account nameText
source version atTimestamp

Subscription items#

Current Paddle subscription item hierarchy at price grain.

FieldType
subscription IDText
subscription item IDText
item indexInteger
price IDText
product IDText
item statusText
quantityInteger
recurring atTimestamp
billing cycle intervalText
billing cycle frequencyInteger
unit amount minorInteger
unit amountNumber
currencyText
created atTimestamp
updated atTimestamp
account IDText
account nameText
source version atTimestamp

Transactions#

Account-scoped billing transaction headers with source-of-truth totals and payout economics.

FieldType
transaction IDText
seller IDText
customer IDText
customer nameText
address IDText
business IDText
business nameText
customer countryText
discount IDText
subscription IDText
invoice numberText
statusText
originText
collection modeText
currencyText
subtotal minorInteger
discount minorInteger
tax minorInteger
total minorInteger
fee minorInteger
earnings minorInteger
balance minorInteger
subtotalNumber
discountNumber
taxNumber
totalNumber
feeNumber
earningsNumber
balanceNumber
adjusted totalNumber
payout currencyText
payout totalNumber
payout feeNumber
payout earningsNumber
exchange rateNumber
payment method typeText
card typeText
item countInteger
billed atTimestamp
revised atTimestamp
created atTimestamp
updated atTimestamp
custom data jsonText
account IDText
account nameText
source version atTimestamp

Transaction items#

Calculated transaction line items with product, price, quantity, discount, tax, and proration.

FieldType
transaction IDText
transaction item IDText
item indexInteger
price IDText
product IDText
product nameText
product typeText
tax categoryText
quantityInteger
tax rateNumber
proration rateNumber
billing period startTimestamp
billing period endTimestamp
unit subtotalNumber
unit discountNumber
unit taxNumber
unit totalNumber
subtotalNumber
discountNumber
taxNumber
totalNumber
currencyText
account IDText
account nameText
source version atTimestamp

Adjustments#

Credits, refunds, chargebacks, and chargeback reversals against Paddle transactions.

FieldType
adjustment IDText
seller IDText
transaction IDText
subscription IDText
customer IDText
actionText
adjustment typeText
statusText
reasonText
currencyText
subtotalNumber
taxNumber
totalNumber
feeNumber
retained feeNumber
earningsNumber
payout currencyText
payout totalNumber
payout feeNumber
payout earningsNumber
item countInteger
created atTimestamp
updated atTimestamp
account IDText
account nameText
source version atTimestamp

Adjustment items#

Adjustment allocation to calculated Paddle transaction line items.

FieldType
adjustment IDText
adjustment item IDText
item indexInteger
transaction item IDText
adjustment item typeText
amountNumber
subtotalNumber
taxNumber
totalNumber
currencyText
account IDText
account nameText
source version atTimestamp