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

# Payouts

> Create payout batches, request invoices, move payouts through stages, and generate statements in Introw.

**Open in Introw:** [Payouts](https://app.introw.io/commission?section=payouts)

## How it works

Payouts are organized into batches, each containing per-partner payouts made up of approved
commission lines. You create a batch by selecting a period and partners, and each partner's payout
then moves through stages such as draft, pending partner invoice, pending payment, and paid. The
payouts view groups batches into tabs for all, upcoming, paid, and declined.

Along the way you can request a partner invoice, which generates a statement and emails the
partner, record purchase order numbers, and mark payouts paid. Partners can upload their invoice
and set a PO from the portal. Payouts can also run on a schedule defined in settings.

## Prerequisites

* Write access to payouts.
* Approved commission lines to pay.
* Commission billing info set for statements.

## Settings & configuration

Payouts are managed at [Payouts](https://app.introw.io/commission?section=payouts).

### Creating a payout batch

Create a payout by choosing a period and the partners or filters to include. Introw attaches the
eligible approved lines into per-partner payouts within the batch.

### Stages

Each partner payout moves through stages: draft, pending approval, pending partner invoice,
pending payment, approved, scheduled, paid, declined, failed, blocked, or postponed. You advance a
payout as it progresses.

### Requesting a partner invoice

Request a partner invoice to generate a statement, set the payout to pending partner invoice, and
email the partner to upload their invoice.

### Statements

Generate a payout statement as a PDF for a partner's records and your own.

### Scheduled payouts

When the payout schedule in settings is not manual, batches can be created automatically on the
configured cadence.

## Setup walkthrough

<Steps>
  <Step title="Open payouts">
    Go to [Payouts](https://app.introw.io/commission?section=payouts).
  </Step>

  <Step title="Create a payout">
    Choose a period and partners to build a batch.
  </Step>

  <Step title="Request invoices">
    Request partner invoices to generate statements.
  </Step>

  <Step title="Advance stages">
    Move payouts through approval to paid.
  </Step>

  <Step title="Confirm paid">
    Mark payouts paid and confirm the records.
  </Step>
</Steps>

## How-to guides

<CardGroup cols={2}>
  <Card title="Request a partner invoice" icon="book-open" href="/features/commissions/payouts/guides/request-a-partner-invoice">
    Generate a statement and collect a partner's invoice before you pay, the invoice-first payout path.
  </Card>

  <Card title="Run a payout cycle" icon="book-open" href="/features/commissions/payouts/guides/run-a-payout-cycle">
    Take approved commission from a new batch all the way to partners marked paid, with statements along the way.
  </Card>
</CardGroup>

## Limits & gotchas

<Warning>
  Only approved commission lines are included in a payout, so review and approve lines first. A payout cannot always be deleted depending on its stage, so handle it through decline or postpone where appropriate. Statements use your commission billing info, so set that before generating them.
</Warning>

## Troubleshooting

* **A partner is missing from a batch** - they had no eligible approved lines for the period.
* **A statement looks incomplete** - your commission billing info is not fully set.
* **A payout will not delete** - its stage prevents deletion; decline or adjust it instead.
