Status de transferência - Pagou Developer Docs

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`	cancelado pelo parceiro bancário após o envio	o valor não volta automaticamente; confira seu saldo e fale com o suporte antes de reenviar
`cancelled`	interrompido antes da execução ou revertido depois	um payout interrompido devolve o valor; após uma reversão, confira seu saldo antes de encerrar 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.rejected mapeia para status de recurso rejected
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