Quem é você. Rede de postos ou clube de abastecimento com programa de fidelidade por litros ou cashback. Problema. O motorista que abastece regularmente não tem benefício além do desconto no litro; pedágio é custo separado e sem relação com o posto. Solução Movvia. O posto cobre o pedágio como cashback vinculado ao abastecimento — cada praça paga equivale a litros ou crédito no clube.
- No cadastro do clube, o cliente informa a placa e autoriza o benefício de pedágio.
- Cadastre a placa via
POST /placascom referência ao cartão do clube. - Receba eventos de passagem e aplique crédito de pedágio proporcional ao histórico de abastecimento do cliente.
- O posto define o teto de benefício mensal por placa — controle via lógica interna, não via API Movvia.
- Passagens que excedem o teto são cobradas normalmente ao cliente no próximo ciclo do clube.
Passo 1 — Cadastrar placa no clube.
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":"DEF4G56","metadata":{"cartao_clube":"clu_321","posto_origem":"PTR-047"}}'Passo 2 — Receber passagem e verificar teto.
{
"evento": "pe.transacao.recebida",
"dados": { "placa": "DEF4G56", "valor": 6.20, "praca": "Dutra KM 154" }
}Passo 3 — Confirmar dentro do teto ou cobrar excedente.
curl -X POST "$BASE_URL/pedidos/ped_b2c3d4e5/confirmar" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"idempotencyKey":"conf_ped_b2c3d4e5"}'O posto absorve o custo do pedágio como benefício de retenção, amortizado pelo aumento de frequência de abastecimento e margem no litro. A Movvia cobra over volume liquidado. Estrutura comercial sob consulta — comercial@movvia.com.br.