# App de mobilidade

**Quem é você.** Plataforma de ride-hailing, delivery ou logística de última milha com frota de motoristas parceiros.
**Problema.** O motorista desconta pedágio do próprio bolso e perde tempo com recarga de TAG; o custo difuso reduz a renda líquida e aumenta churn.
**Solução Movvia.** O app absorve o pedágio como benefício operacional — cada passagem do motorista é liquidada pela plataforma automaticamente.

## Como encaixa no seu produto

- Ao cadastrar o motorista, vincule a placa do veículo via `POST /placas`.
- Receba eventos de passagem em tempo real e associe ao ciclo de corrida ou entrega ativo.
- Debite o valor do pedágio do repasse da corrida ou subsidie como benefício da plataforma.
- Motoristas veem o histórico de pedágios pagos pelo app dentro do painel de ganhos.
- Veículos removidos da frota são descadastrados via `DELETE /placas/{placa}`.


## Fluxo

**Passo 1 — Vincular veículo do motorista.**


```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":"NOP3Q45","metadata":{"motorista_id":"drv_789","categoria":"UberX"}}'
```

**Passo 2 — Receber passagem durante corrida ativa.**


```json
{
  "evento": "pe.transacao.recebida",
  "dados": { "placa": "NOP3Q45", "valor": 11.40, "praca": "Castello Branco KM 28" }
}
```

**Passo 3 — Confirmar após associar à corrida.**


```bash
curl -X POST "$BASE_URL/pedidos/ped_d4e5f6g7/confirmar" \
  -H "Authorization: Basic $MV_KEY" \
  -H "x-parceiro-id: $MV_PARCEIRO_ID" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"conf_ped_d4e5f6g7"}'
```

## Modelo de receita típico

O app absorve o pedágio como custo operacional de benefício ao motorista, amortizado pela redução de churn e aumento de horas online. Negociação de volume com Movvia resulta em taxa fixa por passagem. 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)