{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-parceiros/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Liquidação","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":"liquidação","__idx":0},"children":["Liquidação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Liquidação é o processo de associar passagens a um pedido, cobrar seu cliente e confirmar o pagamento à Movvia. Os três endpoints principais são ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pedidos"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pedidos/{id}/confirmar"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pedidos/{id}/cancelar"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"criar-um-pedido","__idx":1},"children":["Criar um pedido"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Agrupe as passagens que deseja liquidar em um pedido. Use sempre uma ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idempotencyKey"]}," única por operação."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/pedidos \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"transacoes\": [\"t_9f2c7e1a\", \"t_3b8d4f2e\"],\n    \"idempotencyKey\": \"ord_20260424_001\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resposta:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"pedidoId\": \"ped_a1b2c3d4\",\n  \"status\": \"pendente\",\n  \"valor\": 25.00,\n  \"transacoes\": [\"t_9f2c7e1a\", \"t_3b8d4f2e\"],\n  \"criadoEm\": \"2026-04-24T10:00:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"confirmar-um-pedido","__idx":2},"children":["Confirmar um pedido"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Após cobrar seu cliente com sucesso, confirme o pagamento:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/pedidos/ped_a1b2c3d4/confirmar \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"idempotencyKey\": \"conf_20260424_001\"}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resposta:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"pedidoId\": \"ped_a1b2c3d4\",\n  \"status\": \"confirmado\",\n  \"confirnadoEm\": \"2026-04-24T10:05:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancelar-um-pedido","__idx":3},"children":["Cancelar um pedido"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancele se não conseguir cobrar o cliente ou se houver erro no seu fluxo:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/pedidos/ped_a1b2c3d4/cancelar \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"motivo\": \"falha_cobranca\", \"idempotencyKey\": \"canc_20260424_001\"}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"máquina-de-estados","__idx":4},"children":["Máquina de estados"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"pendente → confirmado\npendente → cancelado\nconfirmado → (terminal, sem transição)\ncancelado → (terminal, sem transição)\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pedidos em estado terminal não aceitam novas transições. Tentar confirmar ou cancelar um pedido já confirmado retorna ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prazo-para-confirmação","__idx":5},"children":["Prazo para confirmação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pedidos não confirmados ou cancelados em até 48h são automaticamente cancelados pela plataforma. Um webhook ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pe.pedidos.expirado"]}," é emitido antes da expiração."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Boas práticas"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirme o pedido no mesmo fluxo em que cobra o cliente, não em um job assíncrono."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sempre use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idempotencyKey"]}," distinta para criação e confirmação do mesmo pedido."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Armazene o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pedidoId"]}," para reconciliação antes de confirmar."]}]}]}]},"headings":[{"value":"Liquidação","id":"liquidação","depth":1},{"value":"Criar um pedido","id":"criar-um-pedido","depth":2},{"value":"Confirmar um pedido","id":"confirmar-um-pedido","depth":2},{"value":"Cancelar um pedido","id":"cancelar-um-pedido","depth":2},{"value":"Máquina de estados","id":"máquina-de-estados","depth":2},{"value":"Prazo para confirmação","id":"prazo-para-confirmação","depth":2}],"frontmatter":{"title":"Liquidação — Parceiros Movvia","description":"Como criar pedidos, confirmar e cancelar liquidações de passagens na API de Parceiros Movvia.","seo":{"title":"Liquidação"}},"lastModified":"2026-04-25T15:17:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/parceiros/guides/liquidacao","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}