RevRule by Payload, problem guide
Royalty recoupment is a balance, not a note in a tab.
An advance is paid once. Recouping it correctly takes every revenue event after that, in order, against the right balance, at the right rate, with a record of each step. Here is how the calculation actually works and where manual tracking breaks.
The calculation
Four numbers decide every recoupment run
A recoupment calculation looks simple on the contract page and gets complicated in the ledger. Four values drive it:
The advance balance
The amount still owed back: the original advance plus any recoupable costs added later, minus everything already recouped. It changes with every event, so last quarter's figure is stale the moment new revenue lands.
The recoup rate
The share of the participant's earnings applied against the balance. At 100 percent, the participant earns nothing payable until the advance clears. At 50 percent, half is applied and half is payable now.
The clearing point
The exact event at which the balance reaches zero. Earnings before it are recoupment; earnings after it belong to the participant at the post-recoupment rate. Splitting one event across that line is where hand calculations go wrong.
The post-recoupment rate
Many deals pay a different rate once the advance is earned back, for example a producer moving from recoupment to a 5 percent royalty. Applying the old treatment one period too long quietly underpays the participant.
Worked example
A producer advance, computed event by event
Synthetic demonstration, fictional figures
This example comes from a published synthetic fixture run on the RevRule engine: a fictional 12-artist label, 40 tracks, 5,000 synthetic statement lines. Two producer advances were configured as recoupment balances, $300.00 on one track and $450.00 on another, each at a 100 percent recoup rate against that track's producer pool. The engine applied earnings against each balance in event order, recorded the cumulative recouped amount in the ledger for every line, and moved each producer to the 5 percent post rate only after the balance cleared. Producer totals for the quarter landed between $2,782.99 and $3,063.09, combining recouped amounts and post-rate earnings. All 40 graph ledgers passed hash-chain verification, and an independent re-implementation of the rule math reproduced every participant total exactly. Synthetic data; not a customer result.
The point of the example is not the totals. It is that the balance was never typed in by a person after setup. It was engine state, updated by the same events that produced the earnings, with the cumulative position written into the ledger reason for each line. When the producer asks "how much of my advance is left," the answer is a query, not a reconstruction.
How RevRule handles it
Recoupment as a rule, not a reminder
RevRule is a revenue-rules engine. You define the deal once as a Revenue Graph: participants, shares, and the recoupment terms, including the recoup rate and the rate that applies after the advance clears. Revenue events are recorded as money arrives from your distributor or administrator. RevRule computes each event under the rules in force, applies earnings against outstanding balances in order, and writes every computation to a hash-chained ledger that can be queried by event, participant, or entry type and returned in full as JSON.
Before a live run, simulate it. Simulation is a dry run with zero side effects, so a quarter can be previewed and the recoupment positions checked before anything is final. RevRule does not hold funds, execute payments, or collect royalties. It is the contractual accounting layer for money already collected, downstream of your distributor.
Pricing: $99 one-time perpetual license (uncapped operations, unlimited Revenue Graphs, 1 API key), or managed plans at $29, $79, and $199 per month with higher operation, graph, and key allowances. Evaluation accounts are limited to 1,000 operations per month and 3 Revenue Graphs. Seven-day refunds. Support by email, best effort.
Questions
Recoupment, answered plainly
What is royalty recoupment?
Recoupment is the recovery of an advance or recoupable cost out of a participant's future earnings. Until the balance clears, some or all of what that participant would earn is applied against the advance instead of being paid out. After it clears, the participant earns at the rate the contract sets for the post-recoupment period.
What is a recoup rate?
The recoup rate is the share of a participant's earnings applied against the outstanding advance. At a 100 percent recoup rate, every cent the participant earns reduces the balance until it reaches zero. At 50 percent, half reduces the balance and half is currently payable.
What goes wrong when recoupment is tracked in a spreadsheet?
The balance is state that changes with every revenue event. In a spreadsheet it usually lives in a side tab that someone must remember to update, per participant and per agreement. The common failures are a balance that never gets updated after a busy period, a participant kept at the recoupment rate after the balance cleared, and no record of which events were applied against which advance.
Related guides: a renegotiated split applied late, revenue-share reconciliation in a spreadsheet, contractual waterfall calculation, creator commission splits.