# Sua cobrança em toda carteira.

Você opera um serviço que cobra do motorista ou cidadão em trânsito. A Movvia conecta sua cobrança a dezenas de apps, carteiras digitais e bancos — sem você negociar com cada um.

[Pedir credenciais de sandbox](mailto:comercial@movvia.com.br)

## Quem é o Estabelecimento Comercial

Você é um Estabelecimento Comercial (EC) se:

- Emite cobrança para o usuário final (motorista, empresa, cidadão).
- Opera pedágio free flow, pedágio de barreira, balsa, estacionamento, serviço portuário ou zona azul.
- Quer receber pela rede sem negociar individualmente com carteiras e bancos.
- Detém o relacionamento com o pagador e a responsabilidade pelo título da cobrança.
- Precisa de observabilidade em tempo real sobre cada cobrança (status, liquidante, valor repasado).


Se você **liquida cobranças em nome de outros ECs** (app, banco, carteira), o papel correto é **Parceiro** — veja a [página do Parceiro](/parceiros).

## Como funciona em 3 passos

### 1. Publique a passagem

Cada evento que gera um título (passagem detectada, ticket, embarque) vira uma chamada à API:


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

{
  "referenciaExterna": "PASS-2026-0009871",
  "placa": "ABC1D23",
  "valor": 12.50,
  "tipo": "FREEFLOW",
  "praca": { "id": "imigrantes-km245", "nome": "Imigrantes KM 245", "sentido": "SUL" },
  "categoria": 1,
  "capturadoEm": "2026-04-23T14:32:10Z"
}
```

### 2. Receba pedido de reserva (lock)

Quando um canal autorizado (portal, totem ou parceiro) reserva a passagem para pagamento, você recebe webhook assinado:


```json
{
  "evento": "pe.passagem.reservada",
  "versao": "2",
  "id": "evt_8a3f1b2c9d4e",
  "timestamp": "2026-04-23T14:35:00Z",
  "ecId": "ec_imigrantes_concessionaria",
  "dados": {
    "passagemId": "01JVZ8F4WH9R2T7K5M3N8P6Q4X",
    "referenciaExterna": "PASS-2026-0009871",
    "reservaId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "valor": 12.50,
    "expiresAt": "2026-04-23T14:50:00Z",
    "canal": { "tipo": "PARCEIRO", "id": "carteira-banco-xyz" }
  }
}
```

### 3. Receba pagamento confirmado

Quando o canal confirma pagamento, você recebe o evento final com `nsu`, `txid`, `metodoPagamento`, `origemLiquidacao` e o `reservaId` para correlação:


```json
{
  "evento": "pe.passagem.paga",
  "versao": "2",
  "id": "evt_3c4d5e6f7a8b",
  "timestamp": "2026-04-23T14:38:11Z",
  "ecId": "ec_imigrantes_concessionaria",
  "dados": {
    "passagemId": "01JVZ8F4WH9R2T7K5M3N8P6Q4X",
    "reservaId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "valor": 12.50,
    "valorRepasseLiquido": 12.13,
    "comprovante": {
      "nsu": "000132547890",
      "txid": "MV20260423143810AB7F2C9D",
      "metodoPagamento": "PIX",
      "origemLiquidacao": "PARCEIRO",
      "canalId": "carteira-banco-xyz",
      "pagoEm": "2026-04-23T14:38:10Z"
    }
  }
}
```

Valores liquidados entram no ciclo de repasse combinado em contrato. Conciliação automática por `referenciaExterna`. Detalhes no extrato:


```http
GET /ec-api/v1/extrato?desde=2026-04-01
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}
```

## Casos de uso

| Segmento | Tipo de cobrança | Guia |
|  --- | --- | --- |
| Pedágio free flow | Passagem por OCR/RFID, pós-pago | [Ver caso](/estabelecimentos-comerciais/casos-de-uso/pedagio-freeflow) |
| Pedágio de barreira | Passagem no ato, pré ou pós-pago | [Ver caso](/estabelecimentos-comerciais/casos-de-uso/pedagio-barreira) |
| Balsa / travessia | Embarque de veículo | [Ver caso](/estabelecimentos-comerciais/casos-de-uso/balsa) |
| Estacionamento | Ticket por tempo de permanência | [Ver caso](/estabelecimentos-comerciais/casos-de-uso/estacionamento) |
| Prefeitura / zona azul | Cobrança pública regulada | [Ver caso](/estabelecimentos-comerciais/casos-de-uso/prefeitura-zona-azul) |
| Serviço portuário | Entrada/saída em área concessionada | [Ver caso](/estabelecimentos-comerciais/casos-de-uso/portuario) |


## Vision Dados — monetização do acervo de imagens

Se você opera captura de placas (câmera própria em rodovia, estacionamento ou ponto fiscal), pode rentabilizar o acervo via **Vision Dados**, mais um caso de uso da plataforma EC. Modelo de receita inverso: a Movvia paga você por passagem ingerida e aceita por clientes B2B.

[Ver caso de uso Vision Dados →](/estabelecimentos-comerciais/casos-de-uso/vision-dados-monetizar-acervo)

## Movvia vs. integração direta com carteiras

| Critério | Movvia | Integração direta |
|  --- | --- | --- |
| Canais de liquidação | Toda a rede (N parceiros) | Um por vez |
| Tempo de onboarding | Dias | Semanas a meses por canal |
| Conformidade regulatória | Arranjo financeiro operante | Você negocia por conta |
| Observabilidade por cobrança | Status em tempo real + webhook | Depende de cada parceiro |
| Responsabilidade por fraude | Modelo trustee claro | Contratual a negociar |


## Três pilares da plataforma EC

**Captura automática.** Qualquer evento que você gera (passagem, ticket, embarque) vira cobrança publicada na rede em segundos, sem filas manuais.

**Modelo trustee.** A Movvia custodia os recursos em conta master com subcontas por EC. Saldo auditável em tempo real. Você não precisa virar instituição de pagamento.

**Reconciliação nativa.** Cada cobrança carrega `referenciaExterna` — campo seu, imutável. O extrato e os repasses batem exatamente com seu sistema de origem, sem planilha intermediária.

## Developer experience

- Autenticação: Basic Auth + header `x-ec-id` (credencial por ambiente).
- Webhooks assinados com HMAC-SHA256 — valide antes de processar.
- Idempotência por `referenciaExterna` — envio duplicado não gera cobrança dupla.
- Sandbox disponível em minutos após solicitação.
- Referência da API: OpenAPI 3.1 com exemplos em cURL, Node e Python.
- Status da API EC: em produção.


## Preços

| Plano | Perfil | Taxa |
|  --- | --- | --- |
| Standard | Pedágio e barreira, volume padrão | Consultar comercial |
| Balsa e estacionamento | Ticket médio variável | Consultar comercial |
| Poder público / enterprise | Prefeitura, portuário, volume alto | Consultar comercial |


Repasse em D+0 ou D+1 conforme plano. Taxa deduzida no momento da liquidação — você paga só sobre valor efetivamente recebido.

Qual plano é o seu?
Escreva para [comercial@movvia.com.br](mailto:comercial@movvia.com.br) com tipo de serviço, ticket médio e volume mensal estimado. Respondemos com proposta em até 2 dias úteis.

## Perguntas frequentes

details
summary
Preciso mudar meu sistema de cobrança para virar EC?
Não necessariamente. A Movvia se adapta à forma como você gera a cobrança hoje. O mínimo é publicar cada cobrança via API (ou exportar num webhook que a Movvia consome). Detalhes no onboarding.

details
summary
Em quanto tempo consigo sandbox?
Normalmente em minutos úteis após a solicitação. Envie email para [comercial@movvia.com.br](mailto:comercial@movvia.com.br) com nome da empresa, tipo de serviço e volume estimado.

details
summary
E se o cidadão não pagar?
A cobrança expira no prazo definido no onboarding (padrão: 30 dias). Após isso, volta para o seu fluxo tradicional de cobrança. A Movvia não substitui seu processo de inadimplência — oferece um canal adicional de liquidação.

details
summary
Posso cancelar uma cobrança já publicada?
Sim, enquanto estiver em `PENDENTE`. Se já estiver `EM_LIQUIDACAO`, o cancelamento aguarda liberação do lock. Se `LIQUIDADA`, o fluxo é estorno — tratado como disputa.

details
summary
Como recebo o dinheiro?
Via subconta no banco parceiro (arranjo financeiro regulamentado). Repasse em D+0 ou D+1 conforme plano, com extrato via API ou portal web.

details
summary
A taxa é cobrada antes ou depois da liquidação?
Depois. A taxa Movvia é deduzida no momento da liquidação. Você paga apenas sobre valor efetivamente recebido.

details
summary
Tem limite de volume?
Não há limite rígido. Volumes altos podem exigir plano enterprise com SLA com penalidade e isolamento dedicado. Consulte o time comercial.

details
summary
Como vocês lidam com LGPD?
Minimização obrigatória. Enviamos ao liquidante apenas o necessário para confirmar a cobrança (placa, valor, local genérico). Dados sensíveis ficam com você. RoPA compartilhado em contrato.

## Próximo passo

1. Leia o [guia de modelo trustee](/estabelecimentos-comerciais/guides/modelo-trustee) para entender a custódia de recursos.
2. Leia o [ciclo de repasse](/estabelecimentos-comerciais/guides/ciclo-repasse) para entender quando e como o dinheiro chega.
3. Siga o tutorial [Publicar primeira cobrança](/estabelecimentos-comerciais/tutorials/publicar-primeira-cobranca) para validar o fluxo em sandbox.
4. Abra a [Referência da API](/apis/estabelecimentos-comerciais/vision-dados/openapi) para ver todos os endpoints, schemas e eventos de webhook.