> ## 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.

# How payouts work

> When Civic pays, how a run is processed, and what happens if something fails.

Civic pays every eligible member **once a day**, at the time you choose, on your server's own calendar day.

## The pipeline

Each daily run moves through four stages:

```mermaid theme={null}
flowchart LR
  A[Discover due servers] --> B[Snapshot who is due]
  B --> C[Pay members in batches]
  C --> D[Finalise the batch]
  D --> E[Post a summary]
```

> [card] 1. Discover
>
> Civic checks which servers are due, using each server's own time zone and payout
> time. A server is paid at most once per local day.

> [card] 2. Snapshot
>
> For every due server, Civic works out each member's income and records who is due
> and how much — before any money moves.

> [card] 3. Pay
>
> Members are paid in batches. Each payment is referenced, so a retry cannot pay
> twice.

> [card] 4. Finalise
>
> Civic totals the run, records its outcome, and posts a summary to your payout log
> channel.

## Time zones and the server's day

* Payouts use the **time zone** you set, not UTC and not Discord's clock.
* Each server gets **one payout per local day**.
* Day-to-day changes in your server's calendar — including **daylight saving** — are handled, so the payout still lands at your chosen local time.

## Missed days are not back-paid

If Civic is offline over a payout time, it does **not** pay a double amount later. It resumes at the next scheduled time and reports the day it missed.

> [!WARNING]
>
> This is deliberate. Back-paying a missed run can issue a large, unexpected sum. If you need to compensate for a missed day, do it as a logged adjustment.

## If something fails

* The run is **safe to retry**. Members who were already paid are never paid again.
* If Civic restarts mid-run, it picks up from where it stopped.
* A member who cannot be paid is marked **failed**, and the rest of the run continues.
* The final status reflects what happened:

| Status | Meaning |
| - | - |
| **COMPLETED** | Everyone due was paid. |
| **PARTIAL** | Some were paid, some failed. |
| **FAILED** | Nobody was paid, or there was nothing to pay. |

## Where income lands

Income goes to the member's **bank** or **wallet**, whichever you chose in Settings. See [Payouts](https://docs.civicbot.app/dashboard/payouts.md) to watch runs, and [Payout schedule](https://docs.civicbot.app/dashboard/economy-settings.md) to change the time.


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