← Voltar para Camada de Dados

Como integrar os dados do Mercado Pago no Visio OS

por Lorenzo Lopez Head of Content, Visio

Para integrar os dados do Mercado Pago, a documentação pública dele descreve uma API de relatório de liberações, que gera, agenda e baixa um arquivo CSV com token Bearer, e um MCP Server oficial (páginas consultadas em 12/10/2026). Levado à camada de Dados do Visio OS, o Mercado Pago entra como fonte por loja, nos papéis que ele ocupa na operação, junto da venda do PDV, na mesma linha do tempo.

Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas. Mercado Pago aqui é a fonte financeira da loja: uma só empresa que pode estar na operação como maquininha, como conta e como Pix. A classe geral está em como integrar os dados da maquininha de cartão.

Por que o Mercado Pago importa por ocupar três lugares ao mesmo tempo

O Mercado Pago pode ser três coisas para a mesma loja: a maquininha em que o cartão passa, a conta em que o dinheiro fica e o caminho do Pix. Quem integra precisa saber em qual desses papéis a pergunta está.

Isso muda a conciliação. Se o Mercado Pago é só a maquininha, a pergunta é a do cartão: o que passou, a taxa, o que vai cair e quando, contra a venda do PDV e o extrato do banco. Se é também a conta, a conta dele vira uma trilha própria da loja. Se é também o Pix, a venda sem cartão entra no mesmo recorte.

A camada de Dados do Visio OS trata os três como o que são: fontes da mesma loja, lidas pelo caminho que existe e postas na mesma linha do tempo. O gestor continua perguntando uma coisa só, e a definição de cada número vale para os três papéis.

O que o Mercado Pago documenta

A consulta de 12/10/2026 trouxe três fatos do próprio Mercado Pago.

O primeiro é a API. A documentação (API de relatório de liberações, consultada em 12/10/2026) descreve uma API pública que gera, agenda e baixa um arquivo CSV, autenticada por token Bearer.

O segundo é o arquivo. O relatório de liberações produz um arquivo CSV.

O terceiro é o MCP. Um MCP Server oficial está documentado na visão geral do MCP Server do Mercado Pago, consultada em 12/10/2026. É um fato sobre o fornecedor, e não sobre a Visio.

A página consultada trata do relatório de liberações. Se a mesma API cobre os três papéis, a maquininha, a conta e o Pix, as páginas públicas consultadas não mencionam isso.

O relatório de liberações: gerar, agendar e baixar

Três verbos descrevem a API. Gerar é pedir o relatório. Agendar é programar quando ele sai. Baixar é obter o arquivo. A autenticação é por token Bearer.

Para quem constrói, isso tem um efeito simples: o ponto de contato é um arquivo CSV, produzido sob demanda ou em agenda, e o time trabalha sobre ele. A página lida não lista as colunas; antes de montar a rotina, vale ver um arquivo real de um mês fechado.

O agendamento é um recurso do relatório do Mercado Pago. A frequência de extração da camada é outra coisa: é da Visio, pelo menos todo dia, cada fonte na sua.

O MCP do fornecedor e o MCP da Visio

O Mercado Pago publica um MCP oficial.

Um MCP de fornecedor é um caminho da IA até aquele sistema. A IA que o usa responde pelo que o servidor do Mercado Pago expõe. Ela não traz o PDV, não traz o extrato dos outros bancos, não traz a nota de compra.

A camada de Dados do Visio OS faz o contrário em extensão. Ela lê a fonte pela API ou pela exportação e serve a operação inteira pelo MCP da Visio, com um login só. E onde o fornecedor publica um MCP, como o Mercado Pago, o MCP da Visio opera esse MCP por trás: a sua IA conecta uma vez e gerencia num lugar só.

Isso vale para a IA de qualquer pessoa da operação, com a permissão dela. O gerente da loja 12 vê a loja 12; a gestão vê o grupo. A conexão é a mesma, e quem vê o quê é decidido no dado.

Fale com um especialista sobre o Mercado Pago das suas lojas

Como avaliar o caminho do Mercado Pago: 5 critérios

  1. Em qual papel o Mercado Pago está. Maquininha, conta, Pix ou mais de um. A pergunta que a operação faz decide qual relatório importa.
  2. O token. A API exige token Bearer, e a rotina de leitura depende dele.
  3. API ou arquivo. O relatório pode ser pedido por chamada ou baixado como arquivo.
  4. O que o CSV traz. A página lida não lista as colunas. Veja um arquivo real antes de definir como ele se junta ao PDV.
  5. Uma conexão ou várias. Se a IA da operação já usa o MCP do Mercado Pago, defina se ela conecta a cada fornecedor ou uma vez, pela Visio.

Principais caminhos para integrar os dados do Mercado Pago

Três caminhos nascem no Mercado Pago e o quarto é o que a camada faz com eles.

1. A API de relatório de liberações

É o caminho de programa. A documentação é pública, o relatório é gerado por chamada e a autenticação é por token Bearer. A API devolve o que o Mercado Pago tem; a definição de cada número, a junção com o PDV e com o banco e a permissão por loja ficam com quem constrói por cima.

2. O arquivo CSV baixado do relatório

É o caminho de planilha. O relatório gera o CSV, e quem tem acesso à conta o baixa. Serve a uma conferência pontual; como rotina, depende do agendamento do relatório.

3. O MCP oficial do Mercado Pago

É o caminho de IA. Um servidor MCP oficial está documentado, e a IA que o conecta lê o Mercado Pago diretamente. A limitação é a de qualquer MCP de fornecedor: ele responde pelo que está no sistema dele e deixa o resto da loja de fora.

4. O Mercado Pago como fonte da camada de Dados do Visio OS

Pelo caminho que a conta permitir, o Mercado Pago entra por loja e por CNPJ, nos papéis que ocupa, junto da venda do PDV, do extrato dos bancos (por Open Finance, com o consentimento do titular) e da nota (pelo certificado digital de cada CNPJ). A promessa de integração é a da Visio: integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. A Visio não extrai dado contra os termos de uso de um sistema.

O que o Mercado Pago passa a responder junto do PDV

O Mercado Pago não aparece como uma linha só. Cada papel responde a uma pergunta.

  • Como maquininha. A venda no cartão que o aparelho leu encontra a venda que o PDV registrou. A diferença entre as duas é uma resposta, não um cruzamento de planilhas.
  • Como conta. As liberações da conta do Mercado Pago ficam na linha do tempo da loja, ao lado do extrato dos bancos.
  • Como Pix. A venda sem cartão entra no mesmo recorte por loja, com a mesma definição de receita.
  • Os três juntos. A pergunta “quanto a loja recebeu esta semana” soma os papéis, sem que cada um imponha a sua contagem.

A conciliação vira trabalho da ferramenta, não da pessoa. A IA conectada só lê: não escreve no Mercado Pago, não cria tarefa e não muda meta.

Desde quando o dado do Mercado Pago é bom

Uma loja que passou a usar o Mercado Pago depois das outras tem uma série mais curta. O mapeamento da Visio registra, fonte por fonte, desde quando o dado é bom, e a sua IA respeita essa data ao responder. Sem ela, a comparação entre uma loja nova no Mercado Pago e uma antiga distorce o número sem avisar.

Comparativo dos caminhos para integrar o Mercado Pago

O quadro lista o que a documentação do Mercado Pago descreve.

CritérioAPI de relatório de liberaçõesArquivo CSVMCP oficialCamada de Dados do Visio OS
O que entregaO relatório de liberações, gerado e agendado por chamadaO mesmo relatório em CSVAcesso da IA ao Mercado Pago; o que expõe, não mencionado nas páginas públicasO que o caminho escolhido entrega, estruturado por loja
Quem acessaQuem tem o token BearerQuem tem acesso à contaA IA conectada ao servidorA Visio, a partir do mapeamento
FormatoCSV; as colunas, não mencionado nas páginas públicasCSVNão mencionado nas páginas públicasNa mesma linha do tempo, pelo caminho que existe
Por lojaSe o time construirManualNão mencionado nas páginas públicasSim, com a mesma definição da rede
Quem mantémO time do grupo, com o tokenA pessoa que baixaQuem conecta a IAA Visio: nada para hospedar nem manter

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que o Mercado Pago pede uma pergunta antes de «como integrar os dados do Mercado Pago»: em qual papel ele está na loja. Para ele, a resposta muda o que se concilia, e o guia deve começar por aí.

A posição dele é a de que o MCP oficial do Mercado Pago é um bom fato para citar e apenas um ponto de partida: ele leva a IA a um sistema, e a operação tem vários. Ele vê a camada de Dados do Visio OS como o lugar onde o MCP do fornecedor deixa de ser uma conexão a mais e passa a ser uma das fontes por trás de uma só.

Perguntas frequentes

O Mercado Pago tem API para integrar os dados?

Tem. A documentação do Mercado Pago, consultada em 12/10/2026, descreve uma API de relatório de liberações que gera, agenda e baixa um arquivo CSV, com token Bearer.

O Mercado Pago tem MCP oficial?

Tem. Um MCP Server oficial está documentado nas páginas do Mercado Pago, consultadas em 12/10/2026. As páginas públicas consultadas não mencionam o que o servidor expõe em detalhe.

O MCP do Mercado Pago substitui a integração?

Não. Um MCP de fornecedor é um caminho da IA até aquele sistema e responde pelo que está nele. A camada de Dados do Visio OS lê a fonte pela API ou pela exportação, junta com o PDV, o banco e a nota, e serve tudo pelo MCP da Visio, que opera o MCP do fornecedor por trás.

Dá para baixar os dados do Mercado Pago em arquivo?

Dá. O relatório de liberações gera um arquivo CSV, segundo a documentação consultada em 12/10/2026.

E se o caminho do Mercado Pago na minha operação não estiver claro?

A Visio integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. O primeiro passo é o mapeamento de quais contas Mercado Pago a operação tem e em que papel cada uma atua.

Próximos passos

O primeiro passo é o mapeamento de quais contas Mercado Pago a operação tem, em que papel cada uma atua e de como cada uma conecta.

Para ver a camada completa, leia a página da camada de Dados.

Ver também

Conclusão

O Mercado Pago publica a API de relatório de liberações, o CSV e um MCP oficial. Na camada de Dados do Visio OS, ele entra por loja, nos papéis de maquininha, conta e Pix, junto com a venda do PDV, o banco e a nota.

Fale com um especialista da camada de Dados do Visio OS

Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.