Skip to content
/
Balsa e travessia
Last updated

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

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

{
  "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

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

Previous page
Next page