Pagamentos
Consultar status
Buscar uma transação
GET /v1/payments/{id} retorna a transação atual.
curl 'https://v2.pagnow.com/v1/payments/{id}' \
-H 'apikey: pnk_sua_chave_aqui'Listar transações
GET /v1/payments — lista paginada, mais recentes primeiro.
curl 'https://v2.pagnow.com/v1/payments?page=1&limit=20&status=WAITING_PAYMENT' \
-H 'apikey: pnk_sua_chave_aqui'Parâmetros de query disponíveis: page, limit, status.
Ciclo de status
PENDING → WAITING_PAYMENT → PROCESSING → PAID | APPROVED
→ REFUSED | EXPIRED | CANCELLED
PAID / APPROVED → REFUNDED
PAID / APPROVED → CHARGEBACK | DISPUTE| Status | Significado | Terminal |
|---|---|---|
PENDING | Cobrança criada, aguardando inicialização no provedor. | |
WAITING_PAYMENT | Aguardando pagamento do cliente (QR Code gerado). | |
PROCESSING | Pagamento recebido, processando confirmação. | |
PAID | Pago e confirmado pelo provedor. | sim |
APPROVED | Aprovado (usado por alguns provedores como confirmação final). | sim |
REFUSED | Recusado / falhou na tentativa de pagamento. | sim |
EXPIRED | Cobrança expirou sem pagamento. | sim |
CANCELLED | Cancelada via API antes do pagamento. | sim |
REFUNDED | Reembolsada (total ou parcial). | sim |
CHARGEBACK | Contestação aberta pelo titular do cartão/banco. | sim |
DISPUTE | Disputa em análise (intermediário antes de chargeback). | sim |
PAID/APPROVED são estados finais de sucesso da cobrança. Eventos
posteriores (reembolso, chargeback ou disputa) movem a transação para
REFUNDED/CHARGEBACK/DISPUTE por um fluxo separado.
Prefira receber a confirmação via webhook em vez de fazer polling. Consulte o status apenas como reconciliação ou fallback.
Endpoints auxiliares
| Método | Caminho | Finalidade |
|---|---|---|
GET | /v1/payments/:id/provider-status | Consulta o status diretamente no provedor (reconciliação pontual). |
GET | /v1/payments/:id/receipt | Retorna o comprovante da transação. |
POST | /v1/payments/:id/reconcile | Força a reconciliação manual com o provedor. |
POST | /v1/payments/:id/resend-webhook | Reenvio do webhook para a URL cadastrada na cobrança. |