> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cashweb.cash/llms.txt
> Use this file to discover all available pages before exploring further.

# Revenue

> Ledger retrieval and deterministic reconciliation strategy for partner revenue.

Use `GET /revenue` to retrieve partner-scoped revenue ledger rows.

## Query Model

* `from` / `to` (RFC3339)
* `token`
* `network`
* `include_summary`
* `limit`
* `cursor`

## Deterministic Reconciliation Pattern

1. Run fixed window pulls (for example hourly or daily).
2. Drain each window fully with cursor pagination.
3. Persist checkpoints (`window_start`, `window_end`, `last_cursor`).
4. Re-run recent windows for late-arriving records.

## Recommended Join Keys

* `transaction_id`
* `merchant_reference`
* partner merchant dimensions (`merchant_id`, `terminal_id`)

## Eventual Consistency Guidance

Revenue views are analytics-oriented and may not reflect a just-completed transaction instantly. For strict transaction-state truth, confirm with transaction retrieval endpoints.
