Skip to content
ContractSpec
Start here

reference

Creator compensation receivables, batchable credits and per-item settlement

Receivable review and resolution, approved adjustment credits in payout batches, per-item release, settlement and reconciliation, and CSV export. No money moves.

field.key.label
docs.tech.creator.compensation-payout-items
field.version.label
field.type.label
field.title.label
Creator compensation receivables, batchable credits and per-item settlement
field.tags.label
creator,compensation,payout,ledger
field.owners.label
field.stability.label
public

FINANCE-01h, after the donor creator platform source @ f4cb617b modules/finance/src/payout-batches.ts and payout-batches-contracts.ts (release_item, per-item settle/reconcile, payoutBatchCsv); D-116c/d.

  • Receivables: a negative confirmed delta is a receivable line. While it is recorded it blocks payout eligibility of every obligation and credit of the same creator and campaign (CREATOR_PAYOUT_RECEIVABLE_OPEN). adjustment-line.receivable.review (finance) moves it to reviewed and lifts the block; adjustment-line.receivable.resolve (owner) closes it as waived or recovered_externally with decision references. Neither debits, offsets, collects or transfers anything; the receivable stays a record.
  • Batchable credits: an approved adjustment credit line (its ledger credit adjustment-credit:<lineId>) can be referenced by a batch like an earned obligation, under the same eligibility (engagement state, no open dispute, no pending finalize adjustment, no open receivable) and the same payout hold. A batch with such an item binds each item kind into its digest (creator-payout-batch-v2).
  • Per-item settlement: a batch is settled either as a whole (FINANCE-01g) or per live item, never both (CREATOR_PAYOUT_SETTLEMENT_PATH). payout-batch.item.settlement.record records the external settlement claim of one item for its exact amount; unknown keeps the funds held. payout-batch.item.reconcile matches one item: settled writes its single ledger debit and marks its hold paid; not_settled removes the item from the batch, releases its hold and narrows the approval. The batch becomes settlement_recorded when every live item is settled and reconciled when every live item is reconciled; it is voided when no live item remains.
  • payout-batch.item.release (finance) removes one live, unsettled item of an approved batch, releases its hold and narrows the approval to the remaining items; the withdrawn approval is kept in approvalHistory. The last live item is not released (CREATOR_PAYOUT_LAST_ITEM); void the batch instead.
  • payout-batch.export returns the CSV of one batch (one item line per inclusion, one approval line per approval, current or withdrawn), amounts in integer units plus the decimal at the unit scale, unknown tax empty, operator text guarded against spreadsheet formulas, and its SHA-256. An export is evidence only.
  • Every command is serialized on the workspace lock, checked against the batch or line revision and replayed by its command id. Settlement is evidence only: no provider is called and no money moves.