# Varejo multi-serviço

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

## Como encaixa no seu produto

- O cliente informa a placa no app ou no totem de autoatendimento.
- Você cadastra a placa via `POST /placas` e 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.


## Fluxo

**Passo 1 — Cliente informa placa no app.**


```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":"GHI7J89","metadata":{"cpf_hash":"sha256_do_cpf","loja":"LJ-042"}}'
```

**Passo 2 — Receber passagem e apresentar ao cliente.**


```json
{
  "evento": "pe.transacao.recebida",
  "dados": { "placa": "GHI7J89", "valor": 9.80, "praca": "Bandeirantes KM 32" }
}
```

**Passo 3 — Cliente quita no caixa; confirmar pagamento.**


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

## Modelo de receita típico

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

## Próximo passo

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