# Posto de combustível

**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.

## Como encaixa no seu produto

- No cadastro do clube, o cliente informa a placa e autoriza o benefício de pedágio.
- Cadastre a placa via `POST /placas` com 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.


## Fluxo

**Passo 1 — Cadastrar placa no clube.**


```bash
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.**


```json
{
  "evento": "pe.transacao.recebida",
  "dados": { "placa": "DEF4G56", "valor": 6.20, "praca": "Dutra KM 154" }
}
```

**Passo 3 — Confirmar dentro do teto ou cobrar excedente.**


```bash
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"}'
```

## Modelo de receita típico

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](mailto:comercial@movvia.com.br).

## Próximo passo

- [Quickstart Parceiros](/parceiros/tutorials/quickstart)
- [Referência da API](/apis/parceiros/openapi)