---
id: SCR-ACC-REC-002
title: Payouts list and Add Payout
route: '/console/{tenantId}/accounting/reconciliation/payouts'
surface: console
product_area: accounting
module: reconciliation
revision: 3
status: draft
design_intent: confirmed
origin: >-
  ACCT-M8 plan D6, approved by Andrew 2026-10-22; the built screen is the
  approved baseline
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
purpose: Find recorded deposits and enter another payout from statement evidence.
supports:
  - JNY-ACC-REC-002
  - JNY-ACC-REC-001
  - CAP-ACC-REC-001
  - CAP-ACC-REC-004
permission: >-
  accounting.application.access; shared loading also requires payout,
  settlement-item, reconciliation and exception read grants
entry_from:
  - SCR-ACC-REC-001 stage tiles and payouts link
  - The Reconciliation section navigation
exits_to:
  - '/console/{tenantId}/accounting/reconciliation/payouts/{id}'
displays:
  - field: >-
      Reference, merchant account, processor, bank account, deposit date and
      deposit amount
    source: DOM-ACC-REC-001 attributes (listPayouts)
  - field: 'Status, calculated total, difference and who reconciled it'
    source: >-
      DOM-ACC-REC-001 reconciliation status with DOM-ACC-REC-003 totals (loaded
      reconciliations)
  - field: 'Search, processor and status filters'
    source: Console state applied to the loaded list
  - field: >-
      Add Payout sheet fields (processor, merchant account, bank account,
      deposit amount, deposit date, expected date, reference, bank description,
      notes)
    source: DOM-ACC-REC-001 editable attributes; merchant and bank accounts from Books
actions:
  - label: Add Payout
    operation_id: createPayout
    permission: accounting.payouts.create
    confirm: false
  - label: Open a payout
    operation_id: 'none: navigation to the workspace'
    permission: accounting.payouts.read
    confirm: false
states:
  - loading
  - empty
  - error
  - read-only
validation:
  - BR-CAP-ACC-REC-001-01
  - BR-CAP-ACC-REC-001-03
  - BR-CAP-ACC-REC-001-11
  - BR-CAP-ACC-REC-001-12
  - BR-CAP-ACC-REC-004-09
patterns:
  - Standard ReconPage layout
  - Shared table with clickable records
  - Search input and filter selects
  - Add Payout sheet with dollar-cent parsing
  - Disabled-action PermissionHint
  - Service errors shown in toasts
component: >-
  components/accounting/reconciliation/payouts-screen.tsx (PayoutsScreen),
  payouts-table.tsx, add-payout-sheet.tsx
evidence:
  - >-
    react-console at baf6dae3:
    app/(console)/console/[tenantId]/accounting/reconciliation/payouts/page.tsx;
    components/accounting/reconciliation/payouts-screen.tsx, payouts-table.tsx,
    add-payout-sheet.tsx; lib/accounting/reconciliation/store.tsx
    (createPayout), client.ts.
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-TEN-004, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-005]
---
# Payouts list and Add Payout

## What the Screen Is For

Staff search the unit’s deposits and open the explanation for the chosen payout. The same screen starts manual payout entry.

## What It Shows and Lets People Do

Rows expose deposit references, accounts, reported days, amounts and browser-derived preparation progress. Entry collects merchant, bank, amount, dates and explanatory details, then opens the created payout.

## States and Errors

Shared load failures precede the list; empty rows provide an empty state. Entry errors retain the sheet and show the service message, and look-alike acknowledgement is unavailable.

## Patterns It Must Respect

Standard layout, row navigation, search and the entry sheet follow the built baseline. The form parses dollar cents and the table uses US-dollar formatting, so currency-aware behavior is a finding.