# 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

| Ciclo | Descrição | Perfil típico |
|  --- | --- | --- |
| D+0 | Repasse no mesmo dia da liquidação, até o fechamento do dia | Pedágio free flow, alto volume |
| D+1 | Repasse no dia útil seguinte ao da liquidação | Estacionamento, balsa, padrão |
| Agendado | Repasse 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](mailto: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.



```json
{
  "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:


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

## Consultar histórico de repasses


```http
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.


```json
{
  "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](/estabelecimentos-comerciais/guides/reconciliacao) — como cruzar repasses com cobranças individuais no seu sistema.