Skip to main content
Toda cobrança Pix passa pelos seguintes status:
1

created

A cobrança foi registrada na ZynPay e está sendo enviada ao Banco Central para gerar o QR Code.
2

pending

O QR Code e o Pix Copia e Cola já existem. A cobrança está aguardando o pagamento.
3

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).
4

expired

O prazo de expiração terminou sem pagamento. A cobrança não pode mais ser paga.
5

cancelled / failed / refunded

A cobrança foi cancelada antes do pagamento, falhou ao ser criada, ou foi paga e depois estornada.
Uma cobrança nunca volta atrás depois de paid — ela é um estado final e definitivo.

​
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.

​
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.