{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-parceiros/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Visão geral","description":"APIs públicas da Movvia para parceiros, estabelecimentos comerciais e clientes de dados veiculares.","meta":[{"name":"theme-color","content":"#7E3DEE"},{"name":"apple-mobile-web-app-title","content":"Movvia Docs"},{"name":"application-name","content":"Movvia Docs"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"visão-geral","__idx":0},"children":["Visão geral"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"arquitetura-em-três-camadas","__idx":1},"children":["Arquitetura em três camadas"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A integração de Parceiros funciona em três camadas independentes:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rede de captura"]}," — concessionárias registram passagens de veículos via OCR e RFID. Você não interage com essa camada."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plataforma Movvia"]}," — processa passagens, resolve identidade de placa, cria pedidos e entrega eventos assinados."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Seu produto"]}," — recebe webhooks, decide como cobrar o cliente e confirma o pagamento via API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"papéis","__idx":2},"children":["Papéis"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Papel"},"children":["Papel"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Quem é"},"children":["Quem é"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"O que faz"},"children":["O que faz"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parceiro"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Você"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Publica cobrança ao cliente final; liquida passagens"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Estabelecimento Comercial (EC)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Concessionária, estacionamento, prefeitura"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Emite cobrança original da passagem"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Movvia"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plataforma"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Processa captura, roteia eventos, garante settlement"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fluxo-de-dados","__idx":3},"children":["Fluxo de dados"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Veículo passa na praça\n       ↓\nConcessionária captura (OCR/RFID)\n       ↓\nMovvia processa e resolve placa\n       ↓\nWebhook → seu endpoint (HMAC-SHA256)\n       ↓\nVocê cobra seu cliente\n       ↓\nPOST /pedidos/{id}/confirmar → Movvia\n       ↓\nSettlement concluído\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"modos-de-operação","__idx":4},"children":["Modos de operação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O comportamento de filtragem de eventos depende do seu modo configurado:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["FILTRADO"]}," — você recebe eventos apenas das placas cadastradas via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /placas"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TOTAL"]}," — você recebe todos os eventos da rede coberta."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detalhes em ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/parceiros/guides/modos-operacao"},"children":["Modos de operação"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":5},"children":["Base URL"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Ambiente"},"children":["Ambiente"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Base URL"},"children":["Base URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sandbox (homologação)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://hml.api.pedagioeletronico.com.br"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Produção"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.pedagioeletronico.com.br"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Todos os endpoints usam o prefixo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/gestao-webhooks-api/v1"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Versão do contrato vs versão do path"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v1"]}," no path é a versão HTTP do serviço. O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["info.version"]}," da spec (2.0.0) é o contrato semântico — eles variam de forma independente."]}]}]},"headings":[{"value":"Visão geral","id":"visão-geral","depth":1},{"value":"Arquitetura em três camadas","id":"arquitetura-em-três-camadas","depth":2},{"value":"Papéis","id":"papéis","depth":2},{"value":"Fluxo de dados","id":"fluxo-de-dados","depth":2},{"value":"Modos de operação","id":"modos-de-operação","depth":2},{"value":"Base URL","id":"base-url","depth":2}],"frontmatter":{"title":"Visão geral — Parceiros Movvia","description":"Arquitetura, fluxo de dados e papéis na integração de Parceiros com a API Movvia.","seo":{"title":"Visão geral"}},"lastModified":"2026-04-25T15:17:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/parceiros/guides/visao-geral","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}