> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zynpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ciclo de vida de uma cobrança

> Todos os status possíveis de uma cobrança Pix e o que dispara cada um

Toda cobrança Pix passa pelos seguintes status:

<Steps>
  <Step title="created">
    A cobrança foi registrada na ZynPay e está sendo enviada ao Banco Central para gerar o QR Code.
  </Step>

  <Step title="pending">
    O QR Code e o Pix Copia e Cola já existem. A cobrança está aguardando o pagamento.
  </Step>

  <Step title="paid">
    O pagamento foi confirmado. O valor líquido cai no seu saldo disponível e o webhook `pix.charge.paid` é disparado (se você tiver um endpoint configurado).
  </Step>

  <Step title="expired">
    O prazo de expiração terminou sem pagamento. A cobrança não pode mais ser paga.
  </Step>

  <Step title="cancelled / failed / refunded">
    A cobrança foi cancelada antes do pagamento, falhou ao ser criada, ou foi paga e depois estornada.
  </Step>
</Steps>

<Note>
  Uma cobrança **nunca volta atrás** depois de `paid` — ela é um estado final e definitivo.
</Note>

## Como acompanhar

* **No painel**: a lista de **Cobranças** atualiza o status em tempo real, sem precisar recarregar a página.
* **Pela API**: consulte `GET /v1/pix/charges/{id}` (chave de sessão) ou `GET /v1/public/pix/charges/{id}` (chave de API) a qualquer momento.
* **Por webhook**: assine o evento `pix.charge.paid` para ser avisado no instante em que o pagamento é confirmado — veja [Webhooks](/api/webhooks).

## Reenviar a notificação de um pagamento

Se o seu sistema perdeu a notificação de um webhook, você pode reenviá-la manualmente pelo painel (ou via `POST /v1/pix/charges/{id}/resend-webhook`) — disponível apenas para cobranças já `paid` com um endpoint de webhook ativo assinando o evento.