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

# Payouts

> Watch the payout schedule, preview the next run, and review past batches.

The **Payouts** page shows the state of automatic payouts and a preview of the next one.

> [!NOTE]
>
> **Image needed — `dashboard-payouts.png`**
> Show the Payouts page with the four stat tiles at the top, the preview card, and the batch history table.

## At a glance

Four tiles sit at the top of the page:

| Tile | Shows |
| - | - |
| **Next payout** | When Civic will next pay, and the configured time and time zone. |
| **Last payout** | The date of the last completed payout, or "None yet". |
| **Latest batch** | The status of the most recent run. |
| **Latest batch total** | How much was issued, and how many members were paid. |

## Next payout preview

Civic calculates the next payout using the **same rules a real payout uses** — it just does not move any money. It lists the expected recipients and the totals, so you can review the cost before it runs.

If member data is out of date, a warning appears above the preview. The preview may miss recent role changes until Civic resyncs.

> [!NOTE]
>
> **Image needed — `dashboard-payout-preview.png`**
> Show the "Next payout preview" card with the expected total and recipient count.

## Batch history

Every payout run appears in the table:

| Column | Meaning |
| - | - |
| **Date** | The server-local date the payout covers. |
| **Status** | The outcome of the run. |
| **Eligible** | Members who were due a payment. |
| **Paid** | Members paid successfully. |
| **Failed** | Members who could not be paid. |
| **Total issued** | The total amount paid out. |
| **Completed** | When the run finished. |

### Batch statuses

| Status | Meaning |
| - | - |
| **PENDING** | Created, waiting to be processed. |
| **PROCESSING** | Being paid right now. |
| **COMPLETED** | Every eligible member was paid. |
| **PARTIAL** | Some were paid and some failed. |
| **FAILED** | Nobody was paid, or there was nothing to pay. |

If a batch is **PARTIAL** or **FAILED**, a short error summary appears under its status.

## How payouts are triggered

> [!NOTE]
>
> The dashboard never runs a payout. A background worker is the only thing that schedules and processes payouts. The dashboard only shows what the worker has done.

Civic pays once a day, at your configured time, in your server's time zone. See [How payouts work](https://docs.civicbot.app/concepts/payouts.md) for the full pipeline, and [Payout schedule](https://docs.civicbot.app/concepts/payouts.md) for the daylight-saving and missed-day rules.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.