MercadoLivre - Criando Usuários de Teste na API do Mercado Livre

---

@CanalQb no YouTube

---

🧪 Criando Usuários de Teste na API do Mercado Livre

---

Sempre crie uma frase de segurança única para jogos, testnets ou airdrops e evite usar sua carteira principal.

---

A criação de usuários de teste é uma etapa fundamental no processo de desenvolvimento e homologação de integrações com a API do Mercado Livre. Esses usuários permitem simular operações de compra e venda sem afetar dados reais.

Neste guia, você vai aprender:

• O que é necessário para criar usuários de teste.
• Como verificar se sua aplicação tem permissão.
• Como interpretar a resposta da API.

---

📌 O que é um Usuário de Teste?

Usuários de teste são contas criadas especificamente para simular transações. Com eles, você pode:

• Criar anúncios fictícios.
• Fazer compras simuladas.
• Testar fluxos de envio, devolução, cancelamento, etc.

---

✅ Requisitos para Criar Usuários de Teste

Antes de fazer a requisição para criar um usuário de teste, você precisa garantir que sua aplicação:

1. Esteja ativa.
2. Possua o modo sandbox ativado.
3. Tenha suporte ao fluxo de autenticação client_credentials.
4. Não esteja classificada como traffic-layer, que bloqueia esse recurso.

---

🔐 Verificando Permissões da Aplicação

Para consultar as permissões da sua aplicação, você pode usar o seguinte endpoint:

GET https://api.mercadolibre.com/applications/{APP_ID}
Authorization: Bearer {ACCESS_TOKEN}

A resposta trará dados como:

{
  "id": 1234567890,
  "name": "Nome da Aplicação",
  "sandbox_mode": true,
  "allow_flow": [
    "authorization_code",
    "client_credentials",
    "refresh_token"
  ],
  "certification_status": "not_certified",
  "active": true,
  "roles": [...],
  ...
}

🔎 O que observar:

Campo	Valor Esperado	Observação
sandbox_mode	true	Indica que o ambiente de sandbox está ativo.
allow_flow	Inclui client_credentials	Necessário para autenticação ao criar usuários de teste.
active	true	A aplicação precisa estar ativa.
certification_status	Não afeta diretamente	Mas pode limitar acesso a funcionalidades avançadas.
Erro 403	"client 'traffic-layer' not allowed to perform this action"	Indica que sua aplicação está restrita para este recurso.

---

🚫 Erro Comum

Se ao tentar criar um usuário de teste você receber:

{
  "message": "client 'traffic-layer' not allowed to perform this action",
  "status": 403
}

Isso significa que sua aplicação não possui permissão para criar usuários de teste via API, mesmo que sandbox_mode esteja ativado. Essa é uma restrição imposta pela plataforma.

---

🛠 Criando um Usuário de Teste (caso tenha permissão)

Se sua aplicação atende aos requisitos, você pode usar o seguinte endpoint para criar um usuário de teste:

POST https://api.mercadolibre.com/users/test_user
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

Body:
{
  "site_id": "MLA"
}

Exemplo de resposta bem-sucedida:

{
  "id": 120506781,
  "nickname": "TEST0548",
  "password": "qatest328",
  "site_status": "active"
}

📌 Importante: Guarde essas credenciais com segurança. Não é possível recuperá-las depois.

---

⚠️ Limitações e Regras dos Usuários de Teste

• Cada conta pode criar até 10 usuários de teste.
• As contas de teste expiram após períodos longos de inatividade.
• Os anúncios devem conter "Item de Teste – Por favor, NÃO OFERTAR!" no título.
• Os testes devem ocorrer exclusivamente entre usuários de teste.
• Não publique anúncios de teste como gold ou gold_premium.
• Não é possível recuperar a senha de um usuário de teste. Se perder, crie outro.

---

🧾 Referências

• Documentação Oficial - Usuários de Teste
• API de Aplicações
• API de Sites

---

🧩 Dica extra: Alternativa Manual

Caso sua aplicação não tenha permissão via API, você pode usar o gerador oficial de usuários de teste:

🔗 https://developers.mercadolivre.com.br/pt_br/usuarios-de-teste

---

📬 Solicitação de Permissão

Se sua aplicação estiver restrita (erro de traffic-layer), você pode entrar em contato com o suporte do Mercado Livre e solicitar a liberação para testes:

🔗 Formulário de contato para desenvolvedores

---

💬 Recomendo descrever seu caso de uso, incluir o ID da aplicação e explicar que precisa criar usuários de teste para validação de integrações.

---

📘 Esperamos que este guia ajude você a testar sua integração com mais segurança e praticidade!