A integração de Parceiros funciona em três camadas independentes:
- Rede de captura — concessionárias registram passagens de veículos via OCR e RFID. Você não interage com essa camada.
- Plataforma Movvia — processa passagens, resolve identidade de placa, cria pedidos e entrega eventos assinados.
- Seu produto — recebe webhooks, decide como cobrar o cliente e confirma o pagamento via API.
| 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 |
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ídoO 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.
| 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.