Skip to content
ContractSpec
Start here

reference

Creator compensation accrual v2

Accrues compensation terms v2 from reviewed, provider-qualified observations into immutable ledger credits.

field.key.label
docs.tech.creator.compensation-accrual-v2
field.version.label
field.type.label
field.title.label
Creator compensation accrual v2
field.tags.label
creator,compensation,accrual,ledger
field.owners.label
field.stability.label
public

creator-operations.reward.accrue 2.0.0 takes CreatorAccrueInputV2 and is additive next to v1 (1.0.0).

  • Terms: resolved by termsId/termsVersion among the creator's accepted v2 agreements. Unknown, unaccepted, not-yet-effective and superseded versions are refused. Amendments create a successor version referencing the superseded one; accepted terms never mutate; after the supersession effectiveAt the old version refuses accrual.
  • FINANCE-01h: agreement.accept binds the accepted campaign mode (campaignMode, campaign-modes-v1) into the version, validated with the source validateAcceptedCampaignMode (CREATOR_CAMPAIGN_MODE_INVALID; tracking-only is never accepted). Null or absent is legacy_unspecified. A replay with another mode is an idempotency conflict.
  • Evidence: only provider observations (official API or approved connector, connected and authorized account, read_metrics available, complete and compatible rollup), or manual/self-reported figures with an explicit approved review record. Public sources, tracking-only accounts and unreviewed reports never earn.
  • Availability follows D-049: stale is not_provided. An unavailable total accrues nothing for performance and is recorded with its reasons; it is never a zero credit.
  • Credits: one immutable obligation per fixed or performance obligation key, credited to the ledger only for the delta against prior obligations of the engagement. Replays are idempotent. A lower recomputed total or late evidence after finalization records adjustment_required; nothing is debited silently.
  • Funding (FINANCE-01d, D-075): a credit needs a current managed-budget reservation of the accepted version; without one the outcome is not_managed_budget, and a credit beyond the funded exposure is adjustment_required (exceeds_funded_exposure). v1 accrual refuses once v2 credits exist (and v2 refuses after v1 accruals). See the managed-budget DocBlock.
  • Accrual is a ledger record only: no payment, payout, transfer or settlement happens here.