Skip to main content
Para garantir a consistência financeira, utilizamos uma máquina de estados rigorosa. Uma transação só pode mover-se em uma direção (ex: de Pendente para Aprovado), nunca retroceder.

Ciclo de Vida Visual

Glossário de Status

StatusÍconeSignificado para Payin (Entrada)Significado para Payout (Saída)
PENDINGAguardando pagamento do cliente. O saldo não está disponível.Solicitação criada, aguardando processamento bancário. Valor bloqueado.
APPROVEDPagamento recebido e confirmado. O valor foi creditado no seu saldo.Transferência realizada com sucesso para a conta de destino.
FAILEDErro no pagamento (cartão recusado) ou boleto/pix expirado.Falha no envio (chave inválida ou erro bancário). Saldo estornado.
CANCELEDCobrança cancelada antes do pagamento.N/A (Saques não costumam ser cancelados manualmente após envio).

Tratamento de Erros Comuns

Timeout de Pix

QRCodes Pix expiram em 24 horas por padrão. Se não pago, o status muda automaticamente para FAILED.

Cartão Recusado

Se o status for para FAILED em cartão de crédito, geralmente é falta de saldo ou bloqueio do banco emissor.