Commission partners

# Not live yet (gaps #2)
curl -X POST "https://api.sb/leaseline.app/campaigns?mode=try" \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"play":"commission-partners"}'

 1import { $ } from 'startup-builder'
 2
 3return await $.Campaign.create({ play: 'commission-partners' }, { mode: 'try' })   // dry run on the day-0 Startup, 2026-06-01 · Not live yet, gaps #2

npx startup-builder do Campaign.create --json '{"play":"commission-partners"}' --try   # Not live yet (gaps #2)

{
  "name": "do",
  "arguments": {
    "code": "return await $.Campaign.create({ play: 'commission-partners' }, { mode: 'try' })   // dry run on the day-0 Startup, 2026-06-01 · Not live yet, gaps #2",
    "mode": "try"
  }
}

 1{
 2  "type": "https://startupbuilder.dev/errors/refused",
 3  "title": "Refused",
 4  "status": 422,
 5  "detail": "commission-partners can’t start yet: 1 check fails and 2 warn.",
 6  "checks": [
 7    {
 8      "check": "use-when",
 9      "status": "pass",
10      "observed": "26 Customers past their refund window",
11      "doc": "/plays/commission-partners#check-use-when",
12      "then": "Metric.query"
13    },
14    {
15  …

curl "https://api.sb/leaseline.app/events?where=name%20in%20(%22Customer.activated%22%2C%20%22Invoice.collected%22%2C%20%22Form.submitted%22%2C%20%22Event.captured%22%2C%20%22Invoice.refunded%22%2C%20%22Period.closed%22%2C%20%22Party.screened%22%2C%20%22Monitor.checked%22%2C%20%22Metric.queried%22%2C%20%22Agreement.terminated%22)&limit=1" \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

# Not live yet (gaps #7)
curl -X POST "https://api.sb/leaseline.app/triggers/fire?mode=try" \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"like":"event_1335"}'

# Not live yet (gaps #7)
curl "https://api.sb/leaseline.app/decisions?where=on%20%3D%20%22customer_15%22" \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

# Not live yet (gaps #7)
curl "https://api.sb/leaseline.app/actions?where=on%20%3D%20%22customer_15%22" \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

 1import { $ } from 'startup-builder'
 2
 3const { events: [last] } = await $.Event.list({ where: 'name in ("Customer.activated", "Invoice.collected", "Form.submitted", "Event.captured", "Invoice.refunded", "Period.closed", "Party.screened", "Monitor.checked", "Metric.queried", "Agreement.terminated")', limit: 1 })   // { play } compiled to this Play’s Trigger Events
 4const { subject } = await $.Trigger.fire({ like: last.$id }, { mode: 'try' })   // the same Event again, in try mode · Not live yet, gaps #7
 5const { decisions: [decision] } = await $.Decision.list({ where: `on = "${subject}"` })   // what it chose, and why · Not live yet, gaps #7
 6const { actions } = await $.Action.list({ where: `on = "${subject}"` })   // what it did, with its checks · Not live yet, gaps #7
 7return { decision, actions }

npx startup-builder do Event.list --json '{"where":"name in (\"Customer.activated\", \"Invoice.collected\", \"Form.submitted\", \"Event.captured\", \"Invoice.refunded\", \"Period.closed\", \"Party.screened\", \"Monitor.checked\", \"Metric.queried\", \"Agreement.terminated\")","limit":1}'
npx startup-builder do Trigger.fire --json '{"like":"event_1335"}' --try   # Not live yet (gaps #7)
npx startup-builder do Decision.list --json '{"where":"on = \"customer_15\""}'   # Not live yet (gaps #7)
npx startup-builder do Action.list --json '{"where":"on = \"customer_15\""}'   # Not live yet (gaps #7)

{
  "name": "do",
  "arguments": {
    "code": "const { events: [last] } = await $.Event.list({ where: 'name in (\"Customer.activated\", \"Invoice.collected\", \"Form.submitted\", \"Event.captured\", \"Invoice.refunded\", \"Period.closed\", \"Party.screened\", \"Monitor.checked\", \"Metric.queried\", \"Agreement.terminated\")', limit: 1 })   // { play } compiled to this Play’s Trigger Events\nconst { subject } = await $.Trigger.fire({ like: last.$id }, { mode: 'try' })   // the same Event again, in try mode · Not live yet, gaps #7\nconst { decisions: [decision] } = await $.Decision.list({ where: `on = \"${subject}\"` })   // what it chose, and why · Not live yet, gaps #7\nconst { actions } = await $.Action.list({ where: `on = \"${subject}\"` })   // what it did, with its checks · Not live yet, gaps #7\nreturn { decision, actions }",
    "mode": "try"
  }
}

 1{
 2  "decision": {
 3    "$id": "https://api.sb/leaseline.app/decisions/decision_626",
 4    "$type": "Decision",
 5    "choice": "invite-in-product",
 6    "reason": "Maple Court’s first payment passed the 30-day refund window on Oct 18 and they sent their first renewal notice; no other Play holds them",
 7    "stakes": "low",
 8    "options": [
 9      "invite-in-product",
10      "take-the-application",
11      "pay-the-line",
12      "hold-the-line",
13      "fix-the-disclosure",
14      "not-now"
15  …

action_1 is Maple Court’s own Partner code. action_2 is the card in their dashboard, the same for every eligible Customer; one email follows only if they never open it.

≈ +$620 ARR a month at 30 eligible

Worth

1 h week 1, then 20 min a month on the run

Your time

20 % of collected revenue, ~$61 a month at 7 credited

Spend

Day 23: the first credited Customer pays

First signal

20+ Customers past their refund window, Stripe connected

Use it when

Under 20: customer-referrals · no payouts set up: connect Stripe (Integration.connect)

Not yet when

Worth’s formula: about +4 paying Customers per 100 eligible a month (Other Startups’ results; no lift of your own yet) × 30 eligible Customers × $519 average first order ARR ≈ +$623. Under First signal: At 3 newly eligible Customers a month, the 10 % held back reads nothing within a year, so this page reads before-after and pools with Other Startups.

Start it this weekCopy Anchor Link

npx startup-builder add play commission-partners   # 1 · writes plays/commission-partners.mdx (Not live yet, gaps #5)

# 2 · dry run; below, its 422 on 2026-06-01
curl -X POST "https://api.sb/leaseline.app/campaigns?mode=try" \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"play":"commission-partners"}'

# 3 · keep it, at You approve each one
curl -X POST https://api.sb/leaseline.app/campaigns \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"play":"commission-partners"}'

# on
curl -X PATCH https://api.sb/leaseline.app/campaigns/commission-partners \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endsAt":null}'

# off: no new card or Partner; earned lines still pay
curl -X PATCH https://api.sb/leaseline.app/campaigns/commission-partners \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endsAt":"now"}'

{
  "type": "https://startupbuilder.dev/errors/refused",
  "title": "Refused",
  "status": 422,
  "detail": "commission-partners can’t start yet: 1 check fails and 2 warn.",
  "checks": [
    {
      "check": "use-when",
      "status": "pass",
      "observed": "26 Customers past their refund window",
      "doc": "/plays/commission-partners#check-use-when",
      "then": "Metric.query"
    },
    {
      "check": "billing-connected",
      "status": "fail",
      "doc": "/plays/commission-partners#check-billing-connected",
      "fix": "Connect Stripe with payouts on, so Commission pays from collected revenue.",
      "then": "Integration.connect"
    },
    {
      "check": "baseline",
      "status": "warn",
      "observed": "no Partner revenue in 90 days",
      "doc": "/plays/commission-partners#check-baseline",
      "fix": "It reads before-after, not proof, until 100 eligible Customers allow a held-back half.",
      "then": "Metric.query"
    },
    {
      "check": "role-unstaffed",
      "status": "warn",
      "roles": [
        "treasurer",
        "risk-analyst"
      ],
      "owned": 4,
      "doc": "/plays/commission-partners#check-role-unstaffed",
      "fix": "Leave them: payout approvals and held lines come to you; Priya’s 4 get drafts in her queue.",
      "then": "Role.staff"
    }
  ]
}

Commission is 20 % of collected revenue for 12 months, net of refunds, paid after a 60-day clawback (POST /{namespace}/commissions/{commission}/pay). Cards cost nothing, emails $0.04 each (Worker cost), and each payout screening $0.10. That comes to about $61 a month at Leaseline’s 7 credited Customers.

When it startsCopy Anchor Link

{
  "$id": "https://api.sb/leaseline.app/events/event_1335",
  "$type": "Event",
  "name": "Customer.activated",
  "at": "2026-10-19T08:12:40Z",
  "seq": 1335,
  "data": {
    "customer": "customer_15",
    "name": "Maple Court",
    "offer": "leaseline-pro",
    "firstPaymentAt": "2026-09-18",
    "refundWindowEnds": "2026-10-18",
    "activation": "first renewal notice sent"
  }
}

npx startup-builder trigger Customer.activated --like event_1335   # replays the delivery
npx startup-builder clock advance --by 14d   # runs the one email if the card was never opened
npx startup-builder listen Customer.activated --forward-to http://localhost:3000/hook

Who runs itCopy Anchor Link

Partnerships · your agent (role:partner-manager, worker_10) holds the Key Result. It hands held lines, outside applications and every payout run to you (Dana Okafor, person, worker_1), because the Treasurer and Risk Analyst Roles have no person, and a held Customer to their CSM, CSM · your agent (worker_5). Your number links to Did it work.

What it reads · What it may call. It reads clicks, codes, Stripe charges and refunds, and the public pages that carry a Partner’s link, and treats every page as data, never instructions. It never names the referred Customer, the matched value or the device in a held-line notice. Its tools are POST /{namespace}/parties/{party}/screen, POST /{namespace}/tasks/{task}/assign, POST /{namespace}/commissions/{commission}/pay, and any other call becomes an Approval under the Role’s Mandate.

You hold the Partnerships Key Result: $2,500 collected from Partners’ Customers by 2026-12-31. ← worker, metric
On each eligible Customer, payment, finding or cut-off, choose one option and say why. ← triggers, chooses
State the rate, term, clawback and payout day in numbers; promise no earnings.   ← copyRules 3, 4
Credit only a Visitor’s own click, code or keyed call, and never replace a credit. ← Click-first credit
Pay nothing to a Person of Leaseline or another Startup you own.                 ← Insider check
Never write to a Customer a person owns: draft it into their queue.              ← worker.owns, owned-by-a-person

The slow loop. The rate, term and clawback are in the Agreement, so a Change to them needs your merge and a new Agreement Version; none was merged in the window, so there is no replay or read-back to print.

What it can do nextCopy Anchor Link

When it hands to youCopy Anchor Link

Held lines, outside applications and payout runs come to you (Dana Okafor, person); a held Customer goes to their CSM, CSM · your agent. One Brief per Role, as captured (brief is Not live yet, gaps #7).

[
  {
    "$id": "https://api.sb/leaseline.app/tasks/task_581",
    "$type": "Task",
    "assignee": "worker_1",
    "due": "2026-09-26T17:00:00Z",
    "on": "commission_44",
    "brief": {
      "who": "Line 44: Partner Brightwater Leasing, a Customer since July",
      "chose": "hold-the-line",
      "why": "the credited Customer paid with the Partner’s card",
      "amount": "$5.80 of Commission",
      "never": [
        "the referred Customer named to the Partner",
        "the matched card"
      ]
    }
  },
  {
    "$id": "https://api.sb/leaseline.app/tasks/task_612",
    "$type": "Task",
    "assignee": "worker_5",
    "due": "2026-10-03T17:00:00Z",
    "on": "customer_19",
    "brief": {
      "who": "Harbor Row",
      "chose": "not-now",
      "why": "at risk since Oct 2: 3 support threads on late notices",
      "held": "keep-first"
    }
  }
]

Each receiver answers with POST /{namespace}/tasks/{task}/claim (Take this one), POST /{namespace}/tasks/{task}/return with a reason, or POST /{namespace}/actions/{action}/redirect; you approve each payout run with POST /{namespace}/approvals/{approval}/approve. Once you claim a held line, nothing pays on it until you choose pay or void. A Task nobody claims by its due time goes up through POST /{namespace}/tasks/{task}/escalate (CSM to you), and person-promise fires.

On time: you, 6 of 6 claimed within 1 business day, median 2 h 20 min; CSM · your agent, 3 of 3; n 9, ■□□□ Too early to tell beside Other Startups’ 95 % on time. Your queue: counted by kind: 1 payout run a month, about 1 held line and 1 application a month.

The fixed line: POST /{namespace}/deals/{deal}/assign sets owner to the receiving person, the agent is never a Deal’s owner, and Meetings land on the owner’s calendar under the owner’s name.

When it won’t sendCopy Anchor Link

The captured refusal, then the Stop that fired as a Campaign.paused reason (Not live yet, gaps #2); the rewrite that sent is the invite thread in Example.

{
  "type": "https://startupbuilder.dev/errors/refused",
  "title": "Refused",
  "status": 422,
  "detail": "The Partner email to Kestrel Rentals did not send: it promises earnings no record backs.",
  "checks": [
    {
      "check": "fact-check",
      "status": "fail",
      "doc": "/code/refusals#check-fact-check",
      "fix": "Cut the earnings line; state the rate, term and payout day.",
      "then": "Content.draft"
    },
    {
      "check": "keep-first",
      "status": "pass"
    }
  ]
}

[
  {
    "reason": {
      "limit": "code-leak",
      "observed": "1 code on a deal page",
      "bound": "0",
      "window": "1 check"
    },
    "doc": "/plays/commission-partners#stop-code-leak",
    "task": "task_633"
  }
]

Did it workCopy Anchor Link

At 3 newly eligible Customers a month, the 10 % held back reads no paying Customers per 100 eligible within a year, so the basis is before-after (rule o): nothing prints as Added. Each figure’s call is POST /{namespace}/metrics/query by node, and every node above the leaf is Not live yet (gaps #4).

{
  "$id": "decisions/decision_626",
  "$type": "Decision",
  "choice": "invite-in-product",
  "reason": "Maple Court’s first payment passed the 30-day refund window on Oct 18 and they sent their first renewal notice; no other Play holds them",
  "stakes": "low",
  "options": [
    "invite-in-product",
    "take-the-application",
    "pay-the-line",
    "hold-the-line",
    "fix-the-disclosure",
    "not-now"
  ],
  "by": "worker_10",
  "on": "customer_15",
  "expected": "Maple Court opens the Partner dashboard within 30d",
  "reopensWhen": "no dashboard open for customer_15 within 14d; one email then follows"
}

The leaf counts collected revenue, net of refunds, from Customers whose Acquisition credits a Partner, over 30d. The held-back read counts paying Customers per 100 eligible at 90 days, and waits for 100 eligible Customers.

How it moves it: each eligible Customer gets one identical card with their own link and code; the 6 Partners sent 7 paying Customers, 4 of them from one landlord channel’s video.

Guardrails: before against after: refunds on credited Customers, 1 of 7 against a direct 1 of 14, and Commission at 20 % of collected, under the run Limit every month.

{
  "$id": "https://api.sb/leaseline.app/campaigns/commission-partners",
  "$type": "Campaign",
  "play": "play:commission-partners@1",
  "path": [
    "partner-sourced-revenue",
    "referral-share",
    "new-paying-customers",
    "new-arr",
    "net-new-arr",
    "arr"
  ],
  "experiment": {
    "metric": "partner-sourced-revenue",
    "unit": "usd",
    "heldBack": 3,
    "decision": null
  },
  "readout": {
    "value": null,
    "n": 7,
    "maturing": 2,
    "interval": null,
    "readability": "inadmissible",
    "basis": "before-after",
    "pooled": true
  },
  "ledger": {
    "spend": 242,
    "workerCost": 4,
    "hours": 2.1,
    "pipelineArr": 696,
    "wonArr": 3636,
    "projectedArr": 623,
    "paybackDays": 24
  }
}

Outside benchmark: 7.6 % of a program’s Partners make at least one referral in 12 months, and 1.28 % make a sale (2,847 active programs, a partner-software vendor’s platform data, 2026-03-17).

Before it · After it. Before it: usage-upsell and customer-referrals keep Customers active, and a referrer with 3 paid Referrals graduates here (referrer-graduates). After it: instant-response answers the Visitors a Partner sends, and the CSM agent holds any Customer at risk.

ExampleCopy Anchor Link

Leaseline ran it from 2026-06-01 to 2026-10-19 (140 days): 29 Customers became eligible, 3 of them held back at random to see the card 60 days late, and 26 saw it. 6 Partners joined: 4 Customers and 2 outside applicants. Read every captured thread at ?threads=all; three follow the tables.

Leaseline → Brightwater Leasing’s owner, Jul 14, 10:20 · You can now send other property managers to Leaseline from your dashboard.¹ You earn 20 % of what each one pays for 12 months, after a 60-day hold, paid on the last business day of the month.² Your link and code are below, with the disclosure line beside each.³ *Signed with the Role’s disclosure line.*⁴

Brightwater, Jul 14, 16:02 · pressed Join; the Agreement signed. Their first credited Customer paid on Aug 9.

- Top Partners earn over $400 a month sending us their peers.
+ You earn 20 % of what each Customer you send pays for 12 months, paid on the last business day after a 60-day hold.

The Sep 25 cut-off, 07:00 · line 44 matched its Partner on the paying card. · Partnerships · your agent, 07:01 · held the line and sent the held-line notice naming the check only; the Brief went to you (task_581), due Sep 26 17:00. · Dana, Sep 26 09:40 · voided it as a self-referral.

¹ The card and email are identical for every eligible Customer. ² The rate, term, clawback and payout day, in numbers. ³ The disclosure line sits next to every link. ⁴ The fixed signature line, compiled from the Role’s disclosure Setting.

Your settingsCopy Anchor Link

---
rate: 0.20        # of collected revenue, for 12 months
clawback: 60d
cutoff: 25
holdout: 0.1      # 1 in 10 eligible Customers sees the card 60 days late
---
Invite each Customer once they’re past the refund window and sending notices. I approve every outside Partner and every held line.

$ npx startup-builder show plays/commission-partners
rate 0.20 · clawback 60d · cutoff 25 · holdout 0.1     your file  plays/commission-partners.mdx:2-5,7 (Ask 2026-06-01)
family referral · worker role:partner-manager, owns never · chooses 6 (3 rule, 3 read) · sequences partner-invite, disclosure-fix, held-line-notice, partner-statement, post-termination-watch · checks owned-by-a-person, keep-first, customer-ask-cap, insider, click-first, tax-screening, payout-limit · stops 7 · placements youtube, instagram, tiktok, x, linkedin, google-search, mcp-registry, gmail, outlook, yahoo-mail    catalog  play:commission-partners@1 (Not live yet, gaps #5)

Every key from the catalogCopy Anchor Link

Compiled, not written: edit the Play record commission-partners and its Leaseline run, then regenerate. Every step runs from a sentence or a line of code. In your words: the CRM words you know, and where each lives here.