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

# Payout Status Flow

> Understanding the lifecycle of PIX and TED payout transactions

# Payout Status Notification

We will show the flow of payments for payout, regarding the status.

<Warning>
  Payments (payout) in final statuses: **PAID**, **CANCELED**, **REJECTED**, **INVALID\_DATA** can no longer be updated.
</Warning>

## Payout PIX and TED

```mermaid theme={null}
graph TD
    A[AWAITING] --> B[RECEIVED]
    A --> C[CANCELED]
    B --> D[IN REVIEW]
    B --> E[RECEIVED]
    C --> F[Canceled by operator]
    D --> G[Payment in review compliance team]
    E --> H[The balance and compliance checks have been completed and the payment is ready to be processed]
    E --> I[PROCESSING]
    I --> J[The bank is processing the payment]
    J --> K[PROCESSED]
    K --> L[The bank has processed the payment]
    L --> M[REJECTED]
    L --> N[PAID]
    M --> O[Rejected by the bank or internal compliance rules]
    N --> P[The bank has confirmed the payment]
    F --> Q[SEND WEBHOOK]
    G --> Q
    O --> Q
    P --> Q
    Q --> R[Webhook sent]
```

## Possible payment (payout) status

| STATUS\_CODE | STATUS               | EXPLANATION                                                                                                                        |
| ------------ | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| 7            | Awaiting             | The first status: if you stay in this status for more than 1 minute, it means that no balance in your account to make the payment. |
| 1            | Received             | Payment received and stored in our database.                                                                                       |
| 2            | Processing           | Payment sent for processing.                                                                                                       |
| 5            | Inreview             | Payment sent to our team for review.                                                                                               |
| 8            | Processed            | Payments sent for processing and waiting confirmation from processor.                                                              |
| 3            | Paid                 | Payment made with success.                                                                                                         |
| 4            | Rejected             | Payment rejected by the bank (only TED).                                                                                           |
| 6            | Canceled             | Payment canceled by Merchant (TED or PIX) or Payment rejected by the bank (Only PIX).                                              |
| 11           | Invalid\_data\_input | Data provided invalid or insufficient (only available under client request).                                                       |

<Note>
  You can check the reasons why our compliance team will reject a payment in our article [Rejection reasons payout](/cash-out/rejection-reasons).
</Note>

## Status Details

<AccordionGroup>
  <Accordion title="7 - Awaiting">
    **Initial Status**

    The first status when a payout is created. If the payment stays in this status for more than 1 minute, it means there is no balance in your account to make the payment.

    **Action**: Check your wallet balance using [Get Balance](/api-reference/account/get-balance).

    **Next possible statuses**: Received, Canceled
  </Accordion>

  <Accordion title="1 - Received">
    **Payment Accepted**

    Payment received and stored in our database. The balance and compliance checks have been completed, and the payment is ready to be processed.

    **Next possible statuses**: Processing, In Review
  </Accordion>

  <Accordion title="2 - Processing">
    **Being Processed**

    Payment sent for processing. The bank is processing the payment.

    **Next possible statuses**: Processed
  </Accordion>

  <Accordion title="5 - In Review">
    **Compliance Review**

    Payment sent to our compliance team for review. This happens when additional verification is required.

    **Action**: Wait for compliance team review. This may take some time depending on the case.

    **Next possible statuses**: Processed, Rejected, Canceled
  </Accordion>

  <Accordion title="8 - Processed">
    **Sent to Bank**

    Payments sent for processing and waiting confirmation from processor. The bank has processed the payment and is confirming the transaction.

    **Next possible statuses**: Paid, Rejected
  </Accordion>

  <Accordion title="3 - Paid">
    **Final Status - Success**

    Payment made with success. The bank has confirmed the payment and funds have been transferred to the recipient.

    **This is the final success status**:

    * Funds have been transferred
    * Webhook notification is sent
    * Transaction is complete

    **Action**: No further action needed. Payment completed successfully.
  </Accordion>

  <Accordion title="4 - Rejected">
    **Final Status - Bank Rejection**

    Payment rejected by the bank (only TED). This happens when the bank refuses to process the payment due to internal rules or invalid account information.

    **Common reasons**:

    * Invalid bank account details
    * Account closed or blocked
    * Bank internal policies

    **Action**: Review recipient information and create a new payment with corrected details.
  </Accordion>

  <Accordion title="6 - Canceled">
    **Final Status - Canceled**

    Payment canceled by Merchant (TED or PIX) or Payment rejected by the bank (Only PIX).

    **Reasons**:

    * Manual cancellation by merchant
    * PIX payment rejected by bank
    * Compliance rejection

    **Action**: Check cancellation reason. If needed, create a new payment with corrected information.
  </Accordion>

  <Accordion title="11 - Invalid Data Input">
    **Final Status - Invalid Data**

    Data provided invalid or insufficient (only available under client request).

    **Action**: Review all payment data and ensure all required fields are correctly filled. Create a new payment with valid data.
  </Accordion>
</AccordionGroup>

## Webhook Notifications

<Note>
  Webhooks are sent only for **final statuses**: Paid, Rejected, Canceled
</Note>

### When to Expect Webhooks

<Tabs>
  <Tab title="PIX">
    **Fast Notifications**

    PIX webhooks are sent shortly after payment completion:

    * **Paid**: Within seconds to minutes after bank confirmation
    * **Rejected**: Immediately if rejected by bank
    * **Canceled**: Immediately after cancellation

    ```json theme={null}
    {
      "id": 54321,
      "invoice": "PAYOUT-001",
      "end_to_end": "END-TO-END-ID",
      "status": {
        "id": 3,
        "name": "Paid"
      },
      "updated_at": "2024-06-13T10:05:00.000000Z"
    }
    ```
  </Tab>

  <Tab title="TED">
    **Delayed Notifications**

    TED webhooks are sent after bank processing:

    * **Paid**: After bank confirmation (typically D+1)
    * **Rejected**: After bank rejection (typically D+1)
    * **Canceled**: Immediately after cancellation

    ```json theme={null}
    {
      "id": 54322,
      "invoice": "PAYOUT-002",
      "end_to_end": "END-TO-END-ID",
      "status": {
        "id": 3,
        "name": "Paid"
      },
      "updated_at": "2024-06-14T10:00:00.000000Z"
    }
    ```
  </Tab>
</Tabs>

## Status Monitoring

<Steps>
  <Step title="Create Payment">
    Use [Create Payment](/api-reference/cash-out/payout/create-payment) to initiate a payout.

    Initial status: **Awaiting (7)**
  </Step>

  <Step title="Payment Accepted">
    System validates balance and compliance.

    Status changes to: **Received (1)**
  </Step>

  <Step title="Processing">
    Payment is sent to the bank for processing.

    Status changes to: **Processing (2)** → **Processed (8)**
  </Step>

  <Step title="Receive Webhook">
    Webhook notification is sent with final status.

    Final status: **Paid (3)**, **Rejected (4)**, or **Canceled (6)**
  </Step>
</Steps>

## Status Flow Diagram

### PIX Payment Flow

```
Awaiting (7) → Received (1) → Processing (2) → Processed (8) → Paid (3) ✓
                                                              → Rejected/Canceled (6) ✗
```

### TED Payment Flow

```
Awaiting (7) → Received (1) → Processing (2) → Processed (8) → Paid (3) ✓
                                                              → Rejected (4) ✗
```

### With Compliance Review

```
Awaiting (7) → Received (1) → In Review (5) → Processing (2) → Processed (8) → Paid (3) ✓
                                                                              → Rejected/Canceled (6) ✗
```

## Related Resources

<CardGroup cols={3}>
  <Card title="Create Payment" icon="plus" href="/api-reference/cash-out/payout/create-payment">
    Create PIX or TED payments
  </Card>

  <Card title="Get Payment" icon="magnifying-glass" href="/api-reference/cash-out/payout/get-unique-payment">
    Check payment status
  </Card>

  <Card title="Payout Webhook" icon="webhook" href="/cash-out/payout-webhook">
    Configure webhook notifications
  </Card>

  <Card title="Rejection Reasons" icon="circle-xmark" href="/cash-out/rejection-reasons">
    Understand rejection codes
  </Card>

  <Card title="About Payments" icon="circle-info" href="/cash-out/about-payments">
    Learn about payment types
  </Card>

  <Card title="Get Balance" icon="wallet" href="/api-reference/account/get-balance">
    Check wallet balance
  </Card>
</CardGroup>

## Additional Notes

<Note>
  For more information about webhook configuration and signature validation, check our article [Webhook Signature](/concepts/webhooks).
</Note>

<Warning>
  Payments in **Awaiting** status for more than 1 minute indicate insufficient balance. Always check balance before creating payments.
</Warning>

<Tip>
  Use the **In Review** status to inform users that their payment is under compliance review and may take additional time to process.
</Tip>