For the agency team
Billing operations
Plans, checkout links, invoices, refunds, the outcome fee, billing groups, referrals and the margin page, from the Dashboard.
Stripe runs in test mode today: no real card is charged.
Packages
Set in Settings › Packages. The seed lists Starter first ($990 a month, 3 deliverables, 2 revision rounds, 96 hours; $495 for design partners). The Rulings name the entry package and the managed ones.
Plans
Draft → checkout link → active. The checkout link waits for the client's terms acceptance; Stripe's confirmation activates the plan. A client has at most one active plan.
Per-piece plans
The client saves a card; each request is charged at its stored price when it is approved, or when it is sent (the owner's charge-timing ruling). A declined charge is not retried until the owner retries it.
Invoices
One-off invoices from the Billing page. A paid invoice books a ledger line and mails the receipt.
Change orders
A revision round past the plan's included ones ($150 by default) or a rush. The client accepts it in Agency Studio, or an admin decides it here; accepted means one invoice line, then the work runs.
Credits
A per-piece fee is credited back when a run fails and no retry follows, and when a turnaround round is missed. A missed round on a monthly plan is not counted against it instead.
Refunds
Lowest role: owner. "Refund…" on a charge in the ledger (Plan tab), with a reason; the approvers get a mail. A refund made in Stripe's own dashboard is not booked here.
Outcome fee
Lowest role: admin. On the plan card: offer a fee per confirmed lead or sale and a monthly cap. The KPI must be one the client's outcome plan names ("not agreed" otherwise); the offer can be changed or withdrawn until the client's approver accepts it, then it is read-only. On the 1st of each client-local month the job invoices last month's confirmed units (GA4 only, never the ad platform's count) up to the cap, and skips a month with none.
Billing groups
Lowest role: admin. One billing account for several brands or locations: the owner client's plan is the group plan; members show it read-only as "Billed to". Adding a member invites the owner's approvers to it. A group is dissolved once every other member is removed; a group owner cannot be erased before that.
Referrals
Every client has a referral code (made on first read while the "Referral credit" ruling is on). A lead that signs up through the client's link and activates a plan earns the referrer the ruled credit once, on its Stripe balance, booked as a ledger line; self-referrals earn nothing. Read on the Plan tab.
Holds
A plan past due for more than 3 days, or unpaid, stops new production. Reviews, approvals and downloads keep working.
Margin
Lowest role: admin. Billing › Margin: revenue per client minus four cost lines (model, hosting, payment, human time), against the margin floor (65% by default), with a 12-month chart.
COGS
Model cost per run is copied from the platform; hosting is split over clients by runs each month; payment fees come from Stripe; human time is priced at the ruled rate. Free samples and lead research are acquisition cost, outside margin.
Retention, calibration
On the margin page: net and gross revenue retention and churn per cohort; the quote's real cost against its estimate per service line (shown, never applied).
