Quem é você. Banco digital, fintech ou carteira de pagamentos com base de clientes que possuem veículos. Problema. Seu cliente paga pedágio por canais avulsos (TAG, pix manual) sem visibilidade no extrato e sem integração com o saldo da carteira. Solução Movvia. Cada passagem vira uma linha de extrato automática; o débito acontece no saldo ou cartão do cliente sem fricção.
- Cadastre as placas dos veículos vinculados à conta do cliente via
POST /placas. - Receba o evento
pe.transacao.recebidae exiba notificação push ao cliente. - Debite o valor no saldo ou cartão e confirme via
POST /pedidos/{id}/confirmar. - O histórico de passagens alimenta o extrato nativo do app.
- Clientes PJ podem ter múltiplos veículos e centros de custo — use o campo
metadatapara segmentar.
Passo 1 — Vincular veículo.
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":"ABC1D23","metadata":{"conta_id":"acc_789","nome_cliente":"João Silva"}}'Passo 2 — Receber evento e notificar cliente.
{
"evento": "pe.transacao.recebida",
"dados": { "placa": "ABC1D23", "valor": 12.50, "praca": "KM 245 — Imigrantes" }
}Passo 3 — Debitar e confirmar.
curl -X POST "$BASE_URL/pedidos/ped_a1b2c3d4/confirmar" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"idempotencyKey":"conf_ped_a1b2c3d4"}'O banco captura interchange sobre o débito processado e aplica margem sobre o spread Movvia. Em volume, há rebate sobre o float custodiado durante o ciclo de liquidação. Estrutura comercial detalhada em contrato — consultar comercial@movvia.com.br.