Skip to content
/
Ciclo de repasse
Last updated

Ciclo de repasse

O repasse é a transferência do saldo disponível na subconta EC para a sua conta bancária cadastrada. O ciclo depende do plano contratado.

Ciclos disponíveis

CicloDescriçãoPerfil típico
D+0Repasse no mesmo dia da liquidação, até o fechamento do diaPedágio free flow, alto volume
D+1Repasse no dia útil seguinte ao da liquidaçãoEstacionamento, balsa, padrão
AgendadoRepasse em data fixa (semanal ou quinzenal)Poder público, prefeitura

O ciclo é definido em contrato. Para alterar, entre em contato com comercial@movvia.com.br.

Como o fechamento funciona

No horário de fechamento do seu ciclo (configurado no onboarding), a Movvia:

  1. Soma o saldoDisponivel da subconta.
  2. Deduz a taxa da plataforma sobre o volume do período.
  3. Emite ordem de transferência para sua conta bancária cadastrada.
  4. Gera evento de webhook ec.repasse.agendado com o valor e a previsão.
{
  "evento": "ec.repasse.agendado",
  "ecId": "EC-001",
  "valorBruto": 4821.50,
  "taxaMovvia": 72.32,
  "valorLiquido": 4749.18,
  "previsaoCredito": "2026-04-24",
  "repasseId": "rep_a3f1b2c4"
}

Quando a transferência é confirmada pelo banco:

{
  "evento": "pe.repasse.confirmado",
  "repasseId": "rep_a3f1b2c4",
  "valorLiquido": 4749.18,
  "creditadoEm": "2026-04-24T10:14:33Z"
}

Consultar histórico de repasses

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

Cada item retorna repasseId, valorLiquido, status (AGENDADO, CONFIRMADO, FALHOU) e creditadoEm.

Cobranças que não entram no ciclo atual

Uma cobrança não entra no repasse se:

  • Está em PENDENTE ou EM_LIQUIDACAO no momento do fechamento.
  • Foi liquidada após o horário de corte do ciclo (entra no próximo ciclo).
  • Está em processo de disputa (ESTORNADA pendente de confirmação).
Conciliação pelo repasseId

Cada repasse tem repasseId único. Use-o para cruzar o depósito bancário com as cobranças que o compõem via endpoint /ec/repasses/{repasseId}/cobrancas.

Falha de repasse

Se a transferência bancária falhar (conta inválida, banco indisponível), você recebe ec.repasse.falhou e o valor permanece na subconta até nova tentativa ou instrução manual.

{
  "evento": "ec.repasse.falhou",
  "repasseId": "rep_a3f1b2c4",
  "motivo": "CONTA_INVALIDA",
  "proximaTentativa": "2026-04-25T08:00:00Z"
}

Em caso de falha recorrente, o time de operações da Movvia entra em contato proativamente.

Próximo passo

  • Reconciliação — como cruzar repasses com cobranças individuais no seu sistema.
Previous page
Next page