PIX

Consultar status

GET/api/v1/pix/{id}/status

Consulta o status atual de uma cobrança PIX. Prefira webhooks para saber do pagamento — use esta rota como fallback ou para conciliação.

Requisição

curl https://beta.venopayments.com/api/v1/pix/{id}/status \
  -H "Authorization: Bearer veno_live_..."

Resposta · 200

{
  "id": "uuid",
  "txid": "identificador",
  "status": "paid",
  "amount": 1000,
  "paid_at": "2026-03-23T14:30:00Z",
  "end_to_end_id": "E12345678202603...",
  "external_id": "pedido-123",
  "payer_name": "João Silva",
  "payer_document": "12345678900"
}

Parâmetros de rota

idstring · uuidObrigatório

O id retornado ao criar o PIX.

Campos úteis da resposta

end_to_end_id é o identificador da transação no arranjo PIX, útil para conciliação bancária. payer_name e payer_document identificam quem de fato pagou. Todos os valores possíveis de status estão em Status da transação.