Mercado Livre
Integração com o Mercado Livre: é seguro conectar um app?
Como funciona a conexão oficial, que permissões um aplicativo pode pedir, o que ele consegue e não consegue fazer na sua conta, e as perguntas para o fornecedor antes de autorizar.
Em resumo
- A conexão segura passa pela autorização oficial do Mercado Livre (OAuth). Você digita a senha numa página do próprio Mercado Livre e o aplicativo recebe só um token de acesso, nunca a senha.
- A tela de autorização abre em auth.mercadolivre.com.br. Se o "login do Mercado Livre" aparecer num formulário dentro do site do fornecedor, aquilo não é a autorização oficial.
- Cada aplicativo pede permissões por assunto (anúncios, mensagens, vendas e envios, promoções, faturamento e outros), em leitura ou em leitura e escrita. Com leitura, ele só consulta.
- Os aplicativos conectados ficam em Configuração > Segurança, na sua conta do Mercado Livre. Remover um deles invalida o acesso, e trocar a senha também pode derrubar as conexões.
- Os Termos do Mercado Livre proíbem passar senha, código de verificação ou token a terceiros, e isso pode levar à suspensão da conta.
Uma integração com o Mercado Livre é segura quando a conexão passa pela autorização oficial do Mercado Livre e a sua senha nunca vai para o aplicativo. Nesse caminho, você entra na sua conta numa página do próprio Mercado Livre, vê o que o aplicativo pede e clica em autorizar. O aplicativo recebe um token, uma chave de acesso que só abre o que ele pediu e você aceitou, e que você pode cancelar a qualquer hora. Os problemas aparecem fora disso: o aplicativo que pede a sua senha, a permissão que o fornecedor não sabe explicar e o fornecedor que guarda mal a chave que recebeu.
Tudo aqui foi conferido em outubro de 2026 na documentação para desenvolvedores do Mercado Livre, na Central de Vendedores, nos Termos e condições e na Lei Geral de Proteção de Dados. Este texto não é orientação jurídica.
O que é uma integração com o Mercado Livre
Integração é um sistema de fora do Mercado Livre que trabalha dentro da sua conta: um sistema de gestão (ERP) que baixa os pedidos e emite a nota, um hub que publica o mesmo produto em vários canais, uma ferramenta de estoque, de atendimento ou de financeiro. Ela faz isso pela API do Mercado Livre, a porta que o Mercado Livre abre para outros sistemas, e cada uma é cadastrada lá como um aplicativo. Para o aplicativo enxergar o que é privado da sua conta (vendas, mensagens, faturas), a documentação exige que você o autorize.
Como funciona a autorização: a senha fica com o Mercado Livre
Toda integração que usa a API oficial do Mercado Livre passa pelo mesmo protocolo, o OAuth 2.0, um padrão aberto de autorização usado por várias plataformas. A página de autenticação e autorização do Mercado Livre resume o que ele garante: "o usuário nunca deverá revelar sua senha" e só veem dados privados os aplicativos que tiverem permissão para isso. O guia de segurança para integradores diz o mesmo de outro jeito: com esse protocolo, o vendedor nunca precisa compartilhar a senha, o que reduz o risco de roubo de identidade.
Na prática, a conexão acontece assim:
- No aplicativo, você clica em conectar a conta do Mercado Livre.
- O aplicativo manda você para uma página do Mercado Livre. Se você não estiver logado, o login acontece ali, no Mercado Livre.
- O Mercado Livre mostra o aplicativo e o que ele pede, e você autoriza.
- O Mercado Livre devolve você ao aplicativo com um código de uso único, que o aplicativo troca por um token de acesso.
Daí em diante, o aplicativo fala com o Mercado Livre usando esse token, e o token só abre as partes da conta que você autorizou.
Só quem é administrador da conta consegue autorizar. A documentação diz que, se quem fizer o login for um colaborador (o usuário secundário que o dono cria para a equipe), a autorização falha com um erro próprio. Para conectar a loja, o login tem de ser o da conta principal.
A tela de autorização: onde ela tem que abrir
A documentação oficial mostra o endereço da autorização no Brasil: auth.mercadolivre.com.br. A Central de Vendedores recomenda conferir, na barra do navegador, se o endereço é do Mercado Livre. Na prática: o nome do site, entre o https:// e a barra seguinte, tem de terminar em mercadolivre.com.br (na autorização, auth.mercadolivre.com.br). Um endereço parecido, com letra trocada ou outro final, não é do Mercado Livre.
Na tela, confira três coisas antes de autorizar:
- O nome do aplicativo. Ele precisa ser o da ferramenta que você contratou. Quem cria um aplicativo no Mercado Livre cadastra nome, logo e uma descrição curta, e a página de criação de aplicativos diz que essa descrição é exibida quando o aplicativo pede autorização.
- O que ele pede. As permissões são o assunto da próxima seção.
- O endereço. Se o "login do Mercado Livre" aparecer dentro do site do fornecedor, num formulário com o logo amarelo, com endereço que não é do Mercado Livre, pare. Esse formulário não é a autorização oficial, e o que você digitar nele vai para quem fez a página.
As permissões que um aplicativo pode pedir
Cada aplicativo escolhe, ao ser criado, as permissões de que precisa. O Mercado Livre agrupa essas permissões por assunto, e cada grupo pode ser só de leitura (o aplicativo consulta) ou de leitura e escrita (o aplicativo também cria, altera e apaga). Na página de permissões funcionais, os grupos são estes:
| Permissão | O que ela abre |
|---|---|
| Usuários | Dados da conta. Vem ligada em todo aplicativo. |
| Publicação e sincronização | Criar, alterar, pausar ou excluir anúncios, fotos e preços. |
| Comunicação pré e pós-venda | Ler e enviar perguntas, mensagens e respostas em reclamações. |
| Publicidade | Criar e gerenciar campanhas de publicidade. |
| Métricas do negócio | Indicadores de vendas, estoque, reputação e relatórios. |
| Vendas e envios | Pedidos, envios, devoluções, estornos e reclamações. |
| Promoções, cupons e descontos | Criar e gerenciar ofertas e cupons. |
| Faturamento | Faturas, dados fiscais, recebimentos, movimentos e saldos. |
Na tela de autorização os nomes podem aparecer com pequenas diferenças de redação ("Venda e envios de um produto", por exemplo). O que vale é o assunto de cada grupo.
Na tela, cada grupo aparece como leitura ou como leitura e escrita. Para cada um em escrita, peça ao fornecedor a lista do que ele escreve com ele hoje, e o que ainda fica sem uso. Uma resposta clara e por escrito diz mais sobre a ferramenta do que o tamanho da lista.
O que um aplicativo conectado consegue fazer, e o que não consegue
Com a autorização dada, o aplicativo consegue fazer na sua conta tudo o que as permissões dele cobrem, e consegue fazer isso com você fora do computador. O Mercado Livre chama esse acesso de "offline": a página de criação de aplicativos explica que, com ele, o aplicativo toma ações em nome do usuário mesmo quando ele não está conectado. É assim que uma ferramenta sincroniza estoque às três da manhã.
O guia de segurança do Mercado Livre é direto sobre o risco: um token comprometido dá acesso a pedidos, publicações, mensagens e dados de compradores, entre outros dados sensíveis.
E o que o aplicativo não consegue:
- Sacar ou transferir o seu saldo, pela lista de permissões do Mercado Livre. Nenhum dos grupos acima fala em sacar ou transferir, e, no dinheiro, o de Faturamento só acompanha recebimentos e saldos. O dinheiro fica no Mercado Pago, e a página de gerenciamento de aplicativos diz que, desde 30 de agosto de 2026, a aplicação do Mercado Livre e a do Mercado Pago têm de ser separadas. Se a ferramenta também pede acesso ao Mercado Pago, pergunte para quê. E lembre que escrita em Vendas e envios pode mexer em devoluções e estornos, que mudam quanto da venda fica com você.
- Ver a sua senha. Ela é digitada no Mercado Livre e fica lá.
- Alterar nada com permissão só de leitura. A documentação define leitura como consulta. Criar, alterar e apagar exigem a permissão de escrita.
- Entrar num assunto que ele não pediu. Se o aplicativo tenta usar um grupo de permissão que não tem, o Mercado Livre devolve um erro de acesso negado.
- Continuar depois que você tira o acesso. Revogada a autorização, os tokens do aplicativo deixam de valer.
Quanto tempo a conexão dura e o que a derruba
O token que o aplicativo usa vence em 6 horas, e o aplicativo o renova sozinho com uma segunda chave, chamada de refresh token, que só pode ser usada uma vez e dura 6 meses. Os prazos estão na página de autenticação. Enquanto o aplicativo estiver em uso, a conexão se mantém sem você precisar entrar de novo.
A mesma página lista o que pode derrubar a conexão antes do prazo:
- você trocar a senha da conta;
- você revogar a permissão do aplicativo;
- o aplicativo trocar a própria senha de sistema (a chave secreta que identifica o aplicativo no Mercado Livre);
- o aplicativo ficar 4 meses sem fazer nenhuma chamada ao Mercado Livre.
Ela cita ainda casos internos do Mercado Livre que apagam as credenciais, como a desvinculação de dispositivos e casos de fraude. Na prática, depois de trocar a senha, conte com ter de conectar de novo as ferramentas que você usa.
Como ver e remover os aplicativos conectados à sua conta
Os aplicativos conectados à sua conta ficam em Configuração > Segurança, no Mercado Livre. A Central de Vendedores recomenda conferir, de tempos em tempos, a lista de dispositivos vinculados, os aplicativos a que você deu permissão para operar com a sua conta e as permissões dos seus colaboradores, e diz que os três se gerenciam por essa seção.
Vale abrir essa lista hoje e fazer duas perguntas para cada aplicativo: eu ainda uso isso? Eu sei quem é o fornecedor? Ferramenta que você testou e largou pode continuar conectada enquanto o fornecedor seguir usando o acesso. Remova o que não reconhece e o que não usa mais.
Do lado de quem desenvolve, o guia de segurança do Mercado Livre pede que o aplicativo apague os tokens guardados quando o vendedor o desconecta. Então pergunte ao fornecedor se é isso que acontece quando você cancela.
Sinais de alerta antes de conectar
O primeiro da lista é o mais grave.
- Pedir a sua senha, o código de verificação ou o token. Os Termos e condições gerais proíbem compartilhar login, senha, token, códigos de verificação ou outros dados de acesso com terceiros, e o descumprimento pode levar à suspensão ou ao encerramento imediato da conta. O que acontece com o dinheiro numa suspensão está no texto sobre conta suspensa no Mercado Livre.
- Login fora do Mercado Livre. A tela de autorização é do Mercado Livre, e a senha é digitada no Mercado Livre. Formulário no site do fornecedor pedindo e-mail e senha da sua conta não é integração oficial.
- Permissão de escrita sem explicação. O fornecedor não sabe dizer o que escreve com cada permissão, ou a resposta muda a cada conversa.
Perguntas para fazer ao fornecedor antes de autorizar
O Mercado Livre publica um guia de segurança para quem desenvolve integrações. As perguntas abaixo saem dele e da Lei Geral de Proteção de Dados (LGPD), e a resposta precisa vir por escrito. Se só der para fazer duas, faça a 4 e a 5: elas não exigem saber nada de tecnologia para entender a resposta.
- Como vocês guardam o meu token? O guia pede que os tokens fiquem criptografados no banco de dados, com a chave de criptografia num gerenciador de chaves, longe do código e do próprio banco, e cita um padrão de criptografia, o AES-256.
- O token aparece nos registros do sistema (os logs)? O guia pede que esses registros não gravem tokens nem informações confidenciais da conexão.
- Quem da sua equipe tem acesso a essas credenciais? O guia fala em acesso restrito, e em trocar as credenciais quando alguém que as conhecia deixa a empresa.
- O que vocês escrevem na minha conta, com qual permissão, e o que sai sem eu clicar? A resposta boa é uma lista fechada.
- O que acontece quando eu desconecto? O token tem de ser apagado.
- O que fica guardado depois que eu desconecto, por quê, e como eu peço a exclusão? Os dados da loja incluem nome e endereço de compradores, que são dados pessoais pela LGPD (artigo 5º). A mesma lei manda eliminar o dado pessoal quando o tratamento termina, e lista os casos em que ele pode ser guardado, como o cumprimento de obrigação legal (artigo 16).
Se a resposta demora ou vem vaga, espere antes de autorizar. O Terazi também é um aplicativo conectado ao Mercado Livre, e a página sobre como o Terazi se conecta à sua conta e o que ele pode fazer nela mostra, para ele, a lista fechada que a pergunta 4 pede: cada permissão, o que ele lê, tudo o que escreve e como você tira o acesso.