# Visão geral

## Arquitetura em três camadas

A integração de Parceiros funciona em três camadas independentes:

1. **Rede de captura** — concessionárias registram passagens de veículos via OCR e RFID. Você não interage com essa camada.
2. **Plataforma Movvia** — processa passagens, resolve identidade de placa, cria pedidos e entrega eventos assinados.
3. **Seu produto** — recebe webhooks, decide como cobrar o cliente e confirma o pagamento via API.


## Papéis

| Papel | Quem é | O que faz |
|  --- | --- | --- |
| **Parceiro** | Você | Publica cobrança ao cliente final; liquida passagens |
| **Estabelecimento Comercial (EC)** | Concessionária, estacionamento, prefeitura | Emite cobrança original da passagem |
| **Movvia** | Plataforma | Processa captura, roteia eventos, garante settlement |


## Fluxo de dados


```
Veículo passa na praça
       ↓
Concessionária captura (OCR/RFID)
       ↓
Movvia processa e resolve placa
       ↓
Webhook → seu endpoint (HMAC-SHA256)
       ↓
Você cobra seu cliente
       ↓
POST /pedidos/{id}/confirmar → Movvia
       ↓
Settlement concluído
```

## Modos de operação

O comportamento de filtragem de eventos depende do seu modo configurado:

- **FILTRADO** — você recebe eventos apenas das placas cadastradas via `POST /placas`.
- **TOTAL** — você recebe todos os eventos da rede coberta.


Detalhes em [Modos de operação](/parceiros/guides/modos-operacao).

## Base URL

| Ambiente | Base URL |
|  --- | --- |
| Sandbox (homologação) | `https://hml.api.pedagioeletronico.com.br` |
| Produção | `https://api.pedagioeletronico.com.br` |


Todos os endpoints usam o prefixo `/gestao-webhooks-api/v1`.

Versão do contrato vs versão do path
O `v1` no path é a versão HTTP do serviço. O `info.version` da spec (2.0.0) é o contrato semântico — eles variam de forma independente.