Parceiros
Você publica cobrança. Movvia liquida passagens capturadas pela rede. Sua plataforma — app, banco, carteira, frota — assume a cobrança ao cliente final e confirma o pagamento via API.
Portas de entrada
Cada persona tem contrato de API, onboarding e modelo de receita próprios. Escolha a que descreve o que você faz com o pedágio.
Estabelecimentos Comerciais
Você emite cobrança ao usuário final. Movvia orquestra captura, disputa e repasse. Inclui concessionárias de pedágio free flow e barreira, postos, estacionamentos, balsas, portos, prefeituras. Se opera captura própria, monetiza imagens via Vision Dados (caso de uso de EC).
Protocolo via API — 3 fluxos
A integração com a Movvia é 100% via API REST + webhooks assinados. Mesmo padrão usado por parceiros e estabelecimentos comerciais — só muda quem chama qual endpoint.
- 1
Enviar passagem (EC → Movvia). O EC publica cada cobrança detectada via
POST /ec-api/v1/passagenscom placa, valor, praça e tipo (FREEFLOW ou BARREIRA). A passagem fica disponível para a rede de canais — portal, totem ou parceiro. - 2
Receber pedido de reserva (lock). Quando um canal autorizado quer pagar, ele primeiro reserva. O EC recebe webhook
pe.passagem.reservadacom oreservaIde o canal — exclusividade de 15 minutos para evitar cobrança duplicada. - 3
Receber pagamento confirmado. Confirmado o pagamento, o EC recebe
pe.passagem.pagacomnsu,txid,metodoPagamento(PIX/cartão/dinheiro) eorigemLiquidacao(PORTAL, TOTEM ou PARCEIRO) — suficiente para conciliar e liberar cancela em barreira.
Movvia vs OSAs tradicionais
OSAs (Operadores de Solução de Automação) continuam válidos para quem precisa de um serviço de TAG vinculado ao cliente final. Movvia existe para um caso diferente: produtos que querem integrar pedágio como funcionalidade, não como serviço avulso.
| Aspecto | OSA tradicional | Movvia |
|---|---|---|
| Cobertura | Rede fechada — TAG do operador em cada praça | Multiadquirente — uma API para toda a rede coberta |
| Custo de entrada | Mensalidade e/ou franquia mínima | Sem mensalidade — pague por transação liquidada |
| Liquidação | OSA liquida — cliente final fica preso ao operador | Parceiro liquida — white-label, sem lock-in do cliente |
| Tempo para integrar | 3 a 12 meses (contrato + homologação por operador) | Dias — sandbox on-demand, OpenAPI 3.1 público |