Skip to content
Browse documentation

Clawbacks of billed conversions

What happens when a conversion that is already on a payout statement or invoice is rejected, refunded or changes amount — the difference is billed on the next statement.

Last updated 3 min read

On this page

Advertisers cancel orders, refunds arrive weeks later and reviewers reject leads after a payout has been made. TrackCrown never edits a statement that has been generated. Instead it records the money difference and puts it on the next statement of the same partner or advertiser as a clawback line.

When a clawback is created#

Each approved conversion that is billed is stamped with its payout statement and/or invoice. A clawback entry is recorded automatically whenever such a stamped conversion's billed money changes:

ChangePayout sideInvoice side
Approved → rejected or pending−payout−revenue
Payout or revenue amount changesnew − old payoutnew − old revenue
Marked as duplicate−payout−revenue
Back to approved after a clawback+payout+revenue

It does not matter how the change happens:

  • a reversal postback from the advertiser (status=rejected or a new amount with the same txid or the returned conversion_id), see Reversals;
  • a reviewer rejecting it on Reporting → Conversions;
  • an advertiser rejecting it in their portal (when allowed);
  • a CSV import that changes its status or amounts.

The Adjust amounts… dialog refuses to change the money of a billed conversion ("only its note"), so amount corrections of billed conversions go through status changes, reversal postbacks or imports.

Each entry keeps the signed amount, the currency, the conversion's status reason (for example postback_reversal) and the statement that originally billed it.

Where clawbacks appear#

The next statement generated for the same partner or advertiser in the same currency carries all unsettled entries, whatever its period — like a late approval, a clawback is owed as soon as it happens:

LineWhen
Clawbacks of earlier statements — <offer> (<code>)Net negative amount per offer
Adjustments of earlier statements — <offer> (<code>)Net positive amount (e.g. a rejected conversion re-approved)

Clawbacks are part of the preview, the totals and the minimum-payout decision. Once on a statement they are settled and never billed again.

Example#

A partner was paid 50.00 for a sale on September's statement. On 10 October the advertiser sends a reversal postback for the order. The conversion becomes rejected with reason postback_reversal, and a −50.00 clawback is recorded. October's statement then shows the October earnings plus the line "Clawbacks of earlier statements — Spring Sale (SPR1) −50.00".

When the clawback is larger than the new earnings#

A statement is only created when its total is above zero. If the clawbacks exceed the new earnings, the preview shows Nothing due (payouts) or "No billable revenue" (invoices) and no statement is created; the entries stay unsettled and are deducted from a later statement. Draft invoice and pending payout totals can never become negative.

Voiding a statement#

  • Voiding a statement releases its conversions: they are billed again on the next statement at their current amounts. Clawbacks that were recorded against the voided statement are cancelled out, so nothing is counted twice.
  • Clawbacks that the voided statement carried are released and go on the next statement.

Reports versus statements#

Reports always show the conversions' current state — a rejected conversion simply moves from Conversions to Rejected in its original day. Statements keep the history: the original period stays as billed, and the correction appears on the statement of the period in which it happened.

Partners' view#

Partners see clawback lines on their payout statements in the portal, and the rejected conversion with its status reason on their Conversions page.

Something unclear or missing in this article?Tell us