Status de transações e saques

Toda transação (cash-in) e todo saque (cash-out) tem um campo status que representa em que ponto do ciclo de vida ele está. Use esta referência para saber o que cada valor significa e qual evento de webhook ele dispara.

💡 Os status abaixo são os valores exatos que chegam no campo status da API (formato V1) e que você pode usar para filtrar. No Payload v2, o mesmo evento vira um nome dotado (ex.: APPROVED → cashin.paid).

Status de transação (cash-in)

Status	Significado	Final?	Evento webhook
`PENDING`	Cobrança criada, aguardando pagamento (PIX não pago ou cartão não capturado).	Não	—
`APPROVED`	Pagamento confirmado e valor creditado no seu saldo.	✅	`cashin.paid`
`REJECTED`	Recusada pelo PSP/emissor (ex.: cartão negado). Nenhum crédito é gerado.	✅	—
`CANCELED`	Cancelada antes do pagamento (expiração do PIX ou cancelamento).	✅	—
`REFUNDED`	Estornada com sucesso — o valor voltou ao pagador.	✅	`cashin.refunded`
`REFUNDED_PROCESSING`	Estorno solicitado e em processamento (ainda não concluído).	Não	—
`CHARGEBACK`	Contestação de cartão (chargeback) aberta pelo portador.	Não	`infraction.updated`
`BLOCKED`	Saldo retido por MED / disputa de compliance (Pix).	Não	`infraction.updated`
`INCOSISTENT`	Valor pago ≠ valor cobrado. Anomalia — não entregue nem estorne automaticamente; abra um ticket com o `transaction_id`.	Não	`cashin.paid` (com `status` embutido)
`ERROR`	Falha técnica durante o processamento.	✅	—

Status de saque (cash-out)

Status	Significado	Final?	Evento webhook
`WITHDRAW_INFORMATION`	Registro informativo/interno anterior à solicitação.	Não	—
`WITHDRAW_REQUEST`	Saque solicitado e na fila para processamento.	Não	—
`WITHDRAW_PROCESSING`	Em processamento no PSP / SPI.	Não	—
`WITHDRAW_APPROVED`	Saque concluído — o SPI confirmou a liquidação.	✅	`cashout.success`
`WITHDRAW_RETURNED`	Devolvido pelo banco do recebedor (chave inválida, conta encerrada, etc.). O valor é re-creditado no seu saldo.	✅	`cashout.returned`
`WITHDRAW_REJECTED`	Recusado na validação (saldo insuficiente, chave inválida, limites).	✅	—
`WITHDRAW_ERROR`	Falha técnica no envio do saque.	✅	`cashout.failed`

"Final?" indica se o status é terminal (não muda mais). Os não-finais ainda podem transicionar — ex.: WITHDRAW_PROCESSING → WITHDRAW_APPROVED ou WITHDRAW_RETURNED.

Detalhes dos payloads por evento em Payload v2 e Payload v1.