# Balsa e travessia

**Quem é você.** Você opera uma travessia de balsa ou ferry intermunicipal — a cobrança é gerada quando o veículo embarca.

**Problema.** Cobrança em dinheiro em espécie no embarque causa filas, troco e risco operacional. Meios digitais exigem terminal próprio ou integração por concessão.

**Solução Movvia.** Você publica a cobrança no embarque. O motorista paga no app enquanto espera na fila ou ainda no terminal. Você recebe a confirmação antes da partida.

## Como encaixa no seu produto

- Cobrança publicada quando o veículo é registrado na fila ou no embarque.
- TTL definido no onboarding com margem para a duração da travessia.
- Se a travessia for cancelada (condições climáticas, manutenção), você cancela a cobrança via API antes da liquidação ou solicita estorno após.
- Liquidação confirmada via webhook antes da partida — sem perda de receita por falta de troco.
- Campo `metadata` suporta `tipo_veiculo`, `sentido` e `numero_viagem` para reconciliação com o sistema de controle da balsa.


## Fluxo

### Passo 1 — Publicar a cobrança no embarque


```http
POST /ec-api/v1/passagens
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}
Content-Type: application/json

{
  "referenciaExterna": "BALSA-2026-00812",
  "placa": "MNO3P45",
  "valor": 35.00,
  "tipo": "EMBARQUE_BALSA",
  "localCobranca": "Terminal de Guaratuba — PR",
  "capturadoEm": "2026-04-23T07:05:00Z",
  "metadata": { "numero_viagem": "V-0041", "sentido": "Guaratuba-Matinhos", "tipo_veiculo": "PASSEIO" }
}
```

### Passo 2 — Receber liquidação antes da partida


```json
{
  "evento": "pe.passagem.paga",
  "referenciaExterna": "BALSA-2026-00812",
  "valorLiquidado": 35.00,
  "liquidanteId": "liq_carteira_xy",
  "liquidadoEm": "2026-04-23T07:08:14Z"
}
```

### Passo 3 — Cancelar se a travessia não ocorrer


```http
DELETE /ec-api/v1/passagens/cob_balsa_id
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}
```

Se já liquidada, use o fluxo de estorno com `motivo: "COBRANCA_INDEVIDA"`.

## Modelo de receita típico

Ticket médio de travessia varia por porte do veículo e rota. A taxa Movvia é percentual sobre o volume liquidado, negociada conforme ticket médio e volume mensal. Repasse em D+1 é o padrão para operadoras de balsa.

## Próximo passo

- [Publicar primeira cobrança](/estabelecimentos-comerciais/tutorials/publicar-primeira-cobranca)
- [Referência da API](/apis/estabelecimentos-comerciais/vision-dados/openapi)