{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-estabelecimentos-comerciais/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Modelo trustee","description":"APIs públicas da Movvia para parceiros, estabelecimentos comerciais e clientes de dados veiculares.","meta":[{"name":"theme-color","content":"#7E3DEE"},{"name":"apple-mobile-web-app-title","content":"Movvia Docs"},{"name":"application-name","content":"Movvia Docs"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"modelo-trustee","__idx":0},"children":["Modelo trustee"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Movvia opera como ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"por-que-isso-importa","__idx":1},"children":["Por que isso importa"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consequências práticas:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Você não precisa de conta em banco adquirente própria para receber da rede."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Não há risco de confusão entre recursos de ECs distintos — cada um tem subconta isolada."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A taxa Movvia é separada contabilmente do valor repasado — você nunca vê as duas somadas."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"estrutura-de-contas","__idx":2},"children":["Estrutura de contas"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Conta master Movvia (banco parceiro)\n  └── Subconta EC-001  ← seus recursos\n  └── Subconta EC-002  ← outro EC, sem acesso cruzado\n  └── Conta taxa Movvia ← separada dos recursos dos ECs\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você consulta o saldo da sua subconta a qualquer momento:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/saldo\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resposta:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"ecId\": \"EC-001\",\n  \"saldoDisponivel\": 4821.50,\n  \"saldoBloqueado\": 230.00,\n  \"moeda\": \"BRL\",\n  \"consultadoEm\": \"2026-04-23T15:00:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["saldoBloqueado"]}," representa cobranças em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EM_LIQUIDACAO"]}," — recursos reservados pelo liquidante, ainda não confirmados."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fluxo-de-custódia","__idx":3},"children":["Fluxo de custódia"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cidadão paga no app do liquidante."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Liquidante debita o valor e notifica a Movvia."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Movvia credita na sua subconta (bruto)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No fechamento do ciclo, a Movvia deduz a taxa e agenda o repasse para sua conta bancária cadastrada."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Separação contábil"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"auditoria-em-tempo-real","__idx":4},"children":["Auditoria em tempo real"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Toda movimentação na subconta tem timestamp, referência da cobrança e liquidante responsável. Você pode puxar o extrato por período:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/extrato?desde=2026-04-01&ate=2026-04-30\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"limites-e-regras","__idx":5},"children":["Limites e regras"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Saldo negativo não é permitido — a Movvia não concede crédito."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Estornos são debitados da subconta no momento da confirmação do estorno."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Se o saldo da subconta for insuficiente para cobrir um estorno, a Movvia aciona protocolo de cobertura definido em contrato."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subconta é bloqueada automaticamente em caso de suspeita de fraude detectada pelo compliance da Movvia — você é notificado por email e webhook."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"próximo-passo","__idx":6},"children":["Próximo passo"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/estabelecimentos-comerciais/guides/ciclo-repasse"},"children":["Ciclo de repasse"]}," — quando e como o saldo da subconta vira dinheiro na sua conta bancária."]}]}]},"headings":[{"value":"Modelo trustee","id":"modelo-trustee","depth":1},{"value":"Por que isso importa","id":"por-que-isso-importa","depth":2},{"value":"Estrutura de contas","id":"estrutura-de-contas","depth":2},{"value":"Fluxo de custódia","id":"fluxo-de-custódia","depth":2},{"value":"Auditoria em tempo real","id":"auditoria-em-tempo-real","depth":2},{"value":"Limites e regras","id":"limites-e-regras","depth":2},{"value":"Próximo passo","id":"próximo-passo","depth":2}],"frontmatter":{"title":"Modelo trustee — Estabelecimentos Comerciais Movvia","description":"Como a Movvia custodia recursos dos ECs, estrutura de subconta e separação entre taxa e valor do EC.","seo":{"title":"Modelo trustee"}},"lastModified":"2026-04-25T18:15:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/estabelecimentos-comerciais/guides/modelo-trustee","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}