What does Hosted Retainers and Value-Anchored Shares conclude, in numbers, about “Contract Risk: Service Levels, Minimum Terms, Exit, Price Adjustment and Disputes”?
Answer: The first five chapters worked out the price. Lanyu can measure RM 5,568.75 of value a month; the "Balanced" contract charges a retainer of RM 1,900 covering 1,500 orders, a tiered share above that and a cap of RM 4,800; and we know its lifetime gross margin under sBG retention and how many months it takes to pay back. But the price lives on the quote, and the risk lives in the contract. The same RM 1,900 monthly bill, paired with different service-level, termination, price-adjustment and dispute clauses, can mean twice as much or half as much to the two firms. This chapter takes apart the seven places where hosting contracts most often go wrong. For each one it does the arithmetic first, then sketches how the clause is usually written, and ends with a decision rule that can be checked afterwards.
Scope of the numbers: Marked boxes separate published evidence, runnable calculations, sources and the author's hypotheses, each stating what would refute it.
Data table
The numbers below are printed verbatim by the chapter's Python program and can be reproduced by running it. standard-library Python onlyprinted values that match the answer: 1500, 1900
| Balanced tier: retainer RM 1,900 incl. 1,500 orders, then 0.96 and 0.64 per order | |
| definition orders bill vs_completed | |
| created_incl_test | 1,762 2151.52 +155.52 |
| created | 1,720 2111.20 +115.20 |
| completed | 1,600 1996.00 +0.00 |
| completed_net_of_refunds | 1,552 1949.92 -46.08 |
| year: supplier meter 20460, client recount 19800, overcount 0.0333 | |
| refund at marginal rate 0.96 | 633.60; audit threshold 0.03 crossed: True |
| sample size to estimate a miscount rate near 0.03 within +/- 0.010 (95%) | 1,118 orders |
| sample size to estimate a miscount rate near 0.03 within +/- 0.005 (95%) | 4,472 orders |
| sample size to estimate a miscount rate near 0.05 within +/- 0.010 (95%) | 1,825 orders |
Show the full program
# Chapter 6. p64: What counts as a billable order, how much each definition moves the bill, and an audit plan.
# Lanyu's month counts and the year-end recount are FICTIONAL SAMPLE figures; tiers are those of p70.
import math
TIERS = [(1500, 0.96), (3000, 0.64)] # 6% and 4% of RM 16 service revenue per order
RETAINER, CAP = 1900.0, 4800.0
COUNTS = { # one month, fictional
"created_incl_test": 1762,
"created": 1720,
"completed": 1600,
"completed_net_of_refunds": 1552,
}
def bill(q):
parts = [RETAINER]
for i, (start, rate) in enumerate(TIERS):
end = TIERS[i + 1][0] if i + 1 < len(TIERS) else math.inf
parts.append(max(0.0, min(q, end) - start) * rate)
return min(math.fsum(parts), CAP)
def main():
ref = bill(COUNTS["completed"])
print("Balanced tier: retainer RM {:,.0f} incl. {:,} orders, then 0.96 and 0.64 per order"
.format(RETAINER, 1500))
print("definition orders bill vs_completed")
for k, q in COUNTS.items():
print("%-25s %6s %8.2f %+14.2f" % (k, "{:,}".format(q), bill(q), bill(q) - ref))
year_meter, year_recount = 20460, 19800
over = (year_meter - year_recount) / year_recount
print("year: supplier meter %d, client recount %d, overcount %.4f" % (year_meter, year_recount, over))
print("refund at marginal rate 0.96: %.2f; audit threshold 0.03 crossed: %s"
% ((year_meter - year_recount) * 0.96, over > 0.03))
for p, e in ((0.03, 0.01), (0.03, 0.005), (0.05, 0.01)):
n = math.ceil(1.96 ** 2 * p * (1 - p) / e ** 2)
print("sample size to estimate a miscount rate near %.2f within +/- %.3f (95%%): %s orders"
% (p, e, "{:,}".format(n)))
if __name__ == "__main__":
main()Single source and citation
Fan, Y. (2026). Hosted-Platform Retainers, Value-Anchored Revenue-Share Hybrids and Customer Lifetime Gross-Margin Lock-In (Version 0.1.0), Chapter 6: Contract Risk: Service Levels, Minimum Terms, Exit, Price Adjustment and Disputes. 5D Library. DOI pending
DOI pending · monograph page goes live after publication · 5DL-B-135 · v0.1.0 · CC-BY-NC-ND-4.0
BibTeX
@book{fan2026135,
author = {Fan, Yafu},
title = {Hosted-Platform Retainers, Value-Anchored Revenue-Share Hybrids and Customer Lifetime Gross-Margin Lock-In},
year = {2026},
publisher = {5D Library},
edition = {0.1.0},
note = {DOI pending}
}Other chapter answers in this book
- Chapter 1 · Method: Three Ways to Misprice Hosting, the Value Anchor and the Two-Part Contract
- Chapter 2 · Value Anchoring: Team Hours Saved, Errors Avoided and Growth Absorbed
- Chapter 3 · Two-Part Tariffs: Base Fees, Usage Pricing, Tiers and Caps
- Chapter 4 · Revenue Sharing and Tiered Excess Shares: Floors, Caps, and the Arithmetic of Aligned and Misaligned Incentives
- Chapter 5 · Customer Lifetime Gross Margin: sBG Retention, Cohort Accounting, Discounting and Acquisition Payback
- Chapter 7 · The Hosting Playbook: Four Kinds of Client and the Hosting-Contract Calculator
- Chapter 8 · Practice: Bridgecalc Designs a Three-Tier Contract for Lanyu