O que significam os status de uma transação?

Question

Accepted Answer

O status diz em que ponto do fluxo aquele pagamento está. Os rótulos podem mudar entre painel, API e relatório, mas os estados seguem a mesma lógica: a cobrança foi criada, foi concluída, foi negada, foi revertida ou entrou em disputa.

No cartão existe um detalhe a mais. A transação passa por autorização, quando o emissor aprova a operação, e depois por captura, quando o valor é efetivamente cobrado. Por isso um lançamento pode existir no aplicativo do banco antes de o pagamento estar concluído do lado do vendedor.

Estado	O que significa	O que fazer
Pendente ou aguardando pagamento	A cobrança foi criada, mas o pagamento não foi concluído. É o caso do Pix não pago e do boleto emitido.	Não libere pedido nem acesso. Aguarde a confirmação ou acione recuperação de vendas.
Em análise	A transação está em verificação antes da decisão final, normalmente por regras de risco.	Aguarde a conclusão. Análise não é aprovação e não deve liberar nada.
Aprovado ou pago	O pagamento foi confirmado. É o estado que libera a contrapartida.	Libere pedido ou acesso e guarde o identificador da transação.
Recusado ou falhou	A tentativa não foi concluída. No cartão, a decisão costuma ser do emissor.	Ofereça nova tentativa ou outro meio. Repetir a mesma tentativa sem mudar nada tende a repetir a recusa.
Cancelado	A cobrança foi encerrada antes de virar pagamento confirmado, por expiração ou por ação do vendedor.	Nada a receber. Se o cliente afirma ter pago, verifique se o pagamento entrou em outra transação.
Estornado ou reembolsado	Uma transação confirmada foi revertida, no todo ou em parte.	Ajuste pedido, acesso e conciliação. Estorno parcial mantém a venda com valor menor.
Contestado	O pagamento foi questionado e entrou em fluxo de disputa.	Reúna evidências de aceite, comunicação, entrega ou acesso e responda dentro do prazo do fluxo.

Aprovado não é o mesmo que recebido

Aprovação confirma o pagamento. Disponibilidade do dinheiro é outra coisa e segue a agenda de recebimento, que varia conforme o meio, o arranjo e o contrato. Uma venda pode estar aprovada hoje e ainda não estar disponível para saque.

Se você é o comprador

O que você vê no aplicativo do banco é o lançamento, não o status do pedido. Pagamento aprovado e produto não entregue são assuntos diferentes: o primeiro é do pagamento, o segundo é do vendedor. Guarde o comprovante e o identificador da transação antes de acionar qualquer canal.

Na integração, trate o código do estado como fonte de verdade. Nunca faça a lógica do seu sistema depender do texto exibido na tela. Rótulo pode ser traduzido, renomeado ou apresentado de forma diferente em cada relatório.