Skip to content
/
Modelo trustee
Last updated

Modelo trustee

A Movvia opera como trustee dos recursos liquidados em nome dos ECs. Isso significa que o dinheiro do cidadão passa pela Movvia antes de chegar a você — com separação clara entre o valor que é seu e a taxa da plataforma.

Por que isso importa

Você não precisa ser uma instituição de pagamento para operar. A Movvia detém a autorização regulatória e você opera sob o arranjo financeiro dela.

Consequências práticas:

  • Você não precisa de conta em banco adquirente própria para receber da rede.
  • Não há risco de confusão entre recursos de ECs distintos — cada um tem subconta isolada.
  • A taxa Movvia é separada contabilmente do valor repasado — você nunca vê as duas somadas.

Estrutura de contas

Conta master Movvia (banco parceiro)
  └── Subconta EC-001  ← seus recursos
  └── Subconta EC-002  ← outro EC, sem acesso cruzado
  └── Conta taxa Movvia ← separada dos recursos dos ECs

Você consulta o saldo da sua subconta a qualquer momento:

GET /ec-api/v1/saldo
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}

Resposta:

{
  "ecId": "EC-001",
  "saldoDisponivel": 4821.50,
  "saldoBloqueado": 230.00,
  "moeda": "BRL",
  "consultadoEm": "2026-04-23T15:00:00Z"
}

saldoBloqueado representa cobranças em EM_LIQUIDACAO — recursos reservados pelo liquidante, ainda não confirmados.

Fluxo de custódia

  1. Cidadão paga no app do liquidante.
  2. Liquidante debita o valor e notifica a Movvia.
  3. Movvia credita na sua subconta (bruto).
  4. No fechamento do ciclo, a Movvia deduz a taxa e agenda o repasse para sua conta bancária cadastrada.
Separação contábil

A taxa Movvia nunca transita pela sua subconta. Ela é calculada sobre o valor liquidado e registrada na conta de taxa antes do crédito na sua subconta. O extrato via API reflete o valor bruto — a nota fiscal da Movvia cobre a taxa separadamente.

Auditoria em tempo real

Toda movimentação na subconta tem timestamp, referência da cobrança e liquidante responsável. Você pode puxar o extrato por período:

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

Limites e regras

  • Saldo negativo não é permitido — a Movvia não concede crédito.
  • Estornos são debitados da subconta no momento da confirmação do estorno.
  • Se o saldo da subconta for insuficiente para cobrir um estorno, a Movvia aciona protocolo de cobertura definido em contrato.
  • Subconta é bloqueada automaticamente em caso de suspeita de fraude detectada pelo compliance da Movvia — você é notificado por email e webhook.

Próximo passo

  • Ciclo de repasse — quando e como o saldo da subconta vira dinheiro na sua conta bancária.
Previous page
Next page