# Banco / carteira digital

**Quem é você.** Banco digital, fintech ou carteira de pagamentos com base de clientes que possuem veículos.
**Problema.** Seu cliente paga pedágio por canais avulsos (TAG, pix manual) sem visibilidade no extrato e sem integração com o saldo da carteira.
**Solução Movvia.** Cada passagem vira uma linha de extrato automática; o débito acontece no saldo ou cartão do cliente sem fricção.

## Como encaixa no seu produto

- Cadastre as placas dos veículos vinculados à conta do cliente via `POST /placas`.
- Receba o evento `pe.transacao.recebida` e exiba notificação push ao cliente.
- Debite o valor no saldo ou cartão e confirme via `POST /pedidos/{id}/confirmar`.
- O histórico de passagens alimenta o extrato nativo do app.
- Clientes PJ podem ter múltiplos veículos e centros de custo — use o campo `metadata` para segmentar.


## Fluxo

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


```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":"ABC1D23","metadata":{"conta_id":"acc_789","nome_cliente":"João Silva"}}'
```

**Passo 2 — Receber evento e notificar cliente.**


```json
{
  "evento": "pe.transacao.recebida",
  "dados": { "placa": "ABC1D23", "valor": 12.50, "praca": "KM 245 — Imigrantes" }
}
```

**Passo 3 — Debitar e confirmar.**


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

## Modelo de receita típico

O banco captura interchange sobre o débito processado e aplica margem sobre o spread Movvia. Em volume, há rebate sobre o float custodiado durante o ciclo de liquidação. Estrutura comercial detalhada em contrato — consultar [comercial@movvia.com.br](mailto:comercial@movvia.com.br).

## Próximo passo

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