Quem é você. Supermercado, rede de conveniências, lotérica ou fintech de serviços que já processa pagamento de contas e recargas. Problema. O cliente quer resolver pedágio no mesmo lugar onde paga luz e gás, mas a integração com concessionárias é fragmentada e cara. Solução Movvia. Uma integração única entrega pedágio free flow como mais um item no catálogo de serviços do seu app ou caixa.
- O cliente informa a placa no app ou no totem de autoatendimento.
- Você cadastra a placa via
POST /placase monitora passagens em tempo real. - Passagens pendentes aparecem como débitos disponíveis para quitação imediata.
- O cliente escolhe pagar no caixa, via PIX ou débito — você confirma via API.
- Histórico de passagens quitadas fica no perfil do cliente dentro do seu app.
Passo 1 — Cliente informa placa no app.
curl -X POST "$BASE_URL/placas" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"placa":"GHI7J89","metadata":{"cpf_hash":"sha256_do_cpf","loja":"LJ-042"}}'Passo 2 — Receber passagem e apresentar ao cliente.
{
"evento": "pe.transacao.recebida",
"dados": { "placa": "GHI7J89", "valor": 9.80, "praca": "Bandeirantes KM 32" }
}Passo 3 — Cliente quita no caixa; confirmar pagamento.
curl -X POST "$BASE_URL/pedidos/ped_c3d4e5f6/confirmar" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"idempotencyKey":"conf_ped_c3d4e5f6"}'Conveniência por transação (taxa fixa por pedágio quitado) mais spread sobre o valor liquidado. Simples de modelar pois se assemelha à cobrança de boletos e recargas já no portfólio. Estrutura comercial sob consulta — comercial@movvia.com.br.