Status de Transacoes e Webhooks
Entenda os diferentes status que uma transacao ou saque pode assumir durante seu ciclo de vida.
Status Possiveis
A transacao foi criada e esta aguardando o pagamento do cliente. O QR Code PIX foi gerado e esta disponivel para pagamento.
A solicitacao foi recebida e esta sendo processada. Para saques, significa que o pedido foi enviado ao provedor e aguarda confirmacao.
A operacao foi concluida com sucesso. Para depositos (PixIn), o pagamento foi confirmado. Para saques (CashOut), o valor foi transferido para a conta destino.
A operacao falhou ou foi rejeitada. Isso pode ocorrer por diversos motivos como: saldo insuficiente, chave PIX invalida, conta destino invalida, ou erro no provedor.
A transacao foi estornada. O valor foi devolvido ao pagador original. Isso pode ocorrer por solicitacao do cliente ou por motivos operacionais.
Fluxo de Status
PIX In (Depositos)
Cash Out (Saques)
Dica
Configure webhooks para receber notificacoes em tempo real sobre mudancas de status. Isso permite que sua aplicacao reaja imediatamente a pagamentos confirmados ou falhas.