Quem é você. Operador de programa de pontos, milhas ou cashback com participantes que possuem veículos. Problema. Seu participante acumula pontos mas tem poucas opções de resgate cotidianas; pedágio é custo recorrente e invisível ao programa. Solução Movvia. Cada passagem de pedágio vira uma oportunidade de resgate de pontos — o participante quita a praça com milhas em vez de dinheiro.
- Cadastre as placas dos participantes que optam pelo benefício via
POST /placas. - Receba o evento
pe.transacao.recebidae apresente opção de resgate com pontos equivalentes. - Se o participante aceitar, deduza os pontos e confirme o pedido via API.
- O
metadatada placa pode guardar o ID do participante para reconciliação. - Participantes com saldo insuficiente recebem cobertura parcial ou pagamento misto — lógica interna do seu produto.
Passo 1 — Cadastrar placa do participante.
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":"XYZ9A87","metadata":{"participante_id":"mbr_456","programa":"MilhasPlus"}}'Passo 2 — Receber evento e calcular pontos.
{
"evento": "pe.transacao.recebida",
"dados": { "placa": "XYZ9A87", "valor": 8.75, "praca": "Anhanguera KM 72" }
}Passo 3 — Deduzir pontos e confirmar.
curl -X POST "$BASE_URL/pedidos" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"transacoes":["t_9f2c7e1a"],"idempotencyKey":"ord_mbr456_20260424"}'O programa compra o valor da passagem da Movvia a custo e monetiza via breakage (pontos não resgatados), cotação interna dos pontos acima do custo real e aumento de engajamento dos participantes. Estrutura comercial sob consulta — comercial@movvia.com.br.