Uma cobrança Pix tem ciclo de vida curto e previsível. Modelar esse ciclo corretamente na sua aplicação evita a maior parte dos problemas de suporte.
Status típicos
| Status | O que significa | Ação recomendada |
|---|---|---|
| Pendente | Cobrança criada, aguardando pagamento. | Exibir QR Code e contador. |
| Aprovada | Pagamento liquidado e confirmado por webhook. | Liberar entrega e registrar a venda. |
| Expirada | Prazo terminou sem pagamento. | Oferecer nova cobrança. |
| Cancelada | Encerrada antes do pagamento. | Encerrar o pedido. |
| Estornada | Valor devolvido ao pagador. | Reverter a entrega, quando aplicável. |
Expiração e reaproveitamento
Se o cliente voltar à tela antes do vencimento, reaproveite a cobrança existente em vez de criar outra. Criar cobrança nova a cada visita polui o histórico e confunde a conciliação.
Conciliação
Guarde sempre o identificador da cobrança junto ao pedido e trate o webhook como fonte da verdade sobre o status. Consultas por API servem como reforço quando um evento se perde.
Perguntas frequentes
- Posso mudar o valor de uma cobrança já criada?
- Não. Cancele e crie uma nova cobrança com o valor correto.