## Polling 

![Recebimento de eventos por polling](/assets/polling.718b6cf2ec39c930ebc98d3d0780caba83916417551fdfb789e4c1c4c4821317.3513d994.png)

- Consulte `GET /v1/events:polling` periodicamente. Com eventos → `200` com a lista; sem eventos → `204`.
- **Limite:** no máximo **2 requisições por minuto por token**; a janela reinicia a cada minuto. **Recomendado: a cada 30 s.**
- **TTL dos eventos: 4 h 10 min** (pedidos vão para estado final após 4 h; 10 min de margem).
- **Eventos duplicados acontecem** (inclusive `CREATED` de pedidos antigos). Controle unicidade por `eventId` e data; descarte o que já foi processado.
- Chamar a mesma ação duas vezes (ex.: `/confirm` repetido) retorna `HTTP 422`.


**Acknowledgment (só para polling):**

- Envie `POST /v1/events/acknowledgment` para **todo** polling que trouxe eventos — inclusive eventos que você não usa — senão eles voltam a cada consulta.
- Basta confirmar cada evento uma vez.


Webhooks **não** usam acknowledgment.