# Programa de fidelidade

**Quem é você.** Operador de programa de pontos, milhas ou cashback com participantes que possuem veículos.
**Problema.** Seu participante acumula pontos mas tem poucas opções de resgate cotidianas; pedágio é custo recorrente e invisível ao programa.
**Solução Movvia.** Cada passagem de pedágio vira uma oportunidade de resgate de pontos — o participante quita a praça com milhas em vez de dinheiro.

## Como encaixa no seu produto

- Cadastre as placas dos participantes que optam pelo benefício via `POST /placas`.
- Receba o evento `pe.transacao.recebida` e apresente opção de resgate com pontos equivalentes.
- Se o participante aceitar, deduza os pontos e confirme o pedido via API.
- O `metadata` da placa pode guardar o ID do participante para reconciliação.
- Participantes com saldo insuficiente recebem cobertura parcial ou pagamento misto — lógica interna do seu produto.


## Fluxo

**Passo 1 — Cadastrar placa do participante.**


```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":"XYZ9A87","metadata":{"participante_id":"mbr_456","programa":"MilhasPlus"}}'
```

**Passo 2 — Receber evento e calcular pontos.**


```json
{
  "evento": "pe.transacao.recebida",
  "dados": { "placa": "XYZ9A87", "valor": 8.75, "praca": "Anhanguera KM 72" }
}
```

**Passo 3 — Deduzir pontos e confirmar.**


```bash
curl -X POST "$BASE_URL/pedidos" \
  -H "Authorization: Basic $MV_KEY" \
  -H "x-parceiro-id: $MV_PARCEIRO_ID" \
  -H "Content-Type: application/json" \
  -d '{"transacoes":["t_9f2c7e1a"],"idempotencyKey":"ord_mbr456_20260424"}'
```

## Modelo de receita típico

O programa compra o valor da passagem da Movvia a custo e monetiza via breakage (pontos não resgatados), cotação interna dos pontos acima do custo real e aumento de engajamento dos participantes. 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)