Money

Money is where reports go wrong. BetterFans Link returns it in one shape everywhere so that you never add floats or mix gross with net.

The Money object

{ "amount": 1250, "currency": "USD" }

Keep amounts in cents while you add and compare. Divide by 100 only when you display a number.

const format = (m: { amount: number; currency: string }) =>
  new Intl.NumberFormat("en-US", { style: "currency", currency: m.currency }).format(m.amount / 100);

format({ amount: 1250, currency: "USD" }); // "$12.50"

Gross, net and fee

Most money comes in pairs.

Report gross or net and say which one. Never add a gross number to a net number, and never add gross and net together to get a total. When a report says "revenue" without qualification, use net for what the creator takes home and gross for what fans spent.

Where the numbers come from

Revenue and spend come from the account's transactions. The same sales feed every total. Only sales count: refunds and chargebacks are not in v1, so totals are gross sales, not what remains after refunds.

• A fan's spend.total is lifetime gross with that creator, and spend.net is the net of the same sales. Get fan splits it by type: subscriptions, tips, paid messages, posts and other.
• Revenue summary totals a period, splits it by transaction type and as a time series, and gives the previous period for comparison.
• A mass message, post or tracking link reports the revenue it earned as a gross and net pair.

Totals you must not add

Some numbers already contain others. Adding them counts the same sale twice.

• A mass message's revenue is the total for every copy sent. The copies also show up as single paid messages in each fan's chat. Report one or the other, never the sum.
• A revenue summary's byType and series split the same total two ways. Add within one of them, never across both.
• A fan's spend is part of the account's revenue. Do not add fan spend to account revenue.
• previousPeriod is for comparison only.

Paid messages

A paid message (PPV) has a price. For messages the creator sent, purchased says whether the fan bought it. A message with price set to null is not known to be paid. The sale itself is a transaction of type message. Its messageId is not filled yet and is always null for now, so match a sale to a message by fan and time.