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

# Status de transferência

> Mapeie os status das transferências Pix para o seu fluxo operacional.

Use um único mapa de status para produto, operação e suporte.

## Status do recurso da API

| Status        | Significado                        | Ação típica                              |
| ------------- | ---------------------------------- | ---------------------------------------- |
| `pending`     | aceito, mas ainda não final        | monitore                                 |
| `scheduled`   | agendado para execução futura      | mantenha agendado                        |
| `in_analysis` | uma revisão adicional é necessária | mantenha na fila e visível para operação |
| `processing`  | liquidação em andamento            | aguarde webhook ou reconcilie            |
| `paid`        | liquidado com sucesso              | marque o payout como concluído           |
| `rejected`    | bloqueado antes da liquidação      | encaminhe para revisão operacional       |
| `cancelled`   | interrompido de forma intencional  | encerre a solicitação                    |
| `error`       | falhou durante o processamento     | investigue a política de retentativa     |
| `unknown`     | ainda não normalizado              | reconcilie imediatamente                 |

## Mapeamento de eventos de webhook

Status do recurso e nomes de eventos de webhook não são idênticos.

* `payout.transferred` mapeia para status de recurso `paid`
* `payout.failed` mapeia para status de recurso `error`
* `payout.canceled` mapeia para status de recurso `cancelled`

## Por que isso importa

Se o seu produto mostrar nomes de evento como se fossem status de recurso, a operação fica ambígua. Mantenha um mapeamento canônico e reutilize-o em webhook, dashboard e reconciliação.

## Leia a seguir

* [Eventos de transferência](/pt/webhooks/transfer-events)
* [Reconciliação de transferências](/pt/payouts/pix-out/reconciliation)