> For the complete documentation index, see [llms.txt](https://docs.txn.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.txn.io/payouts/payout-status-flow.md).

# Payout status flow

| status     | Final state? | Description                                                                                                                                                                                                                     |
| ---------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| draft      | no           | A payout draft has been created. Only returned when using the [optional draft flow](/payouts/drafting-payout-optional.md). The draft must be confirmed within 30 seconds, otherwise it expires and is cancelled.                |
| processing | no           | The payout has been accepted and is in flight. The transaction is being prepared and broadcast, or has been broadcast and is awaiting its first on-chain confirmation.                                                          |
| completed  | yes          | The transaction has received at least one on-chain confirmation.                                                                                                                                                                |
| cancelled  | yes          | The payout did not complete and will not proceed. Possible causes include an address flagged during compliance screening, insufficient account balance, an expired or rejected draft, or an unexpected issue during processing. |

```mermaid
stateDiagram-v2
    [*] --> draft : draft flow only
    [*] --> processing : standard flow
    draft --> processing : confirmed
    draft --> cancelled : expired or cancelled
    processing --> completed
    processing --> cancelled
```

{% hint style="info" %}
Processing is immediate in most cases. Delays can occur when a transaction requires compliance review or when liquidity needs to be rebalanced before the transaction can be broadcast.
{% endhint %}

## Approval status

Dashboard-initiated payouts subject to an approval rule carry an additional `approvalStatus` field reflecting where the payout sits in the approval workflow. API-created payouts always return `null` for this field.

See the [Approvals feature guide](/getting-setup/approvals-feature-guide.md) for how approval rules work.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.txn.io/payouts/payout-status-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.