Como lidar com a verificação por SMS do Mercado Libre em fluxos de teste e operação

A situação: desenvolver sobre um marketplace que reúne vários sites

O Mercado Libre opera sites regionais separados na América Latina, e uma integração de vendedores, um painel de logística ou uma ferramenta de monitoramento de preços muitas vezes precisa ser testada em vários deles. Cada conta de teste está ligada a um país, e cada uma, cedo ou tarde, pede um número de telefone. Equipes que dependem de celulares de colaboradores acabam com números pessoais ligados a contas empresariais e com testes parados à espera de quem estiver acordado.

Um número virtual para o Mercado Libre da OTP Route dá a QA e operações um caminho mais limpo: um número no mercado certo, um código capturado por API e nenhum chip pessoal envolvido. Equipes de marketplace podem ler mais em marketplaces.

Quando o Mercado Libre pede um número de telefone?

Como a maioria dos grandes marketplaces, o Mercado Libre usa a verificação por telefone em alguns pontos previsíveis: quando uma conta é criada, quando alguém entra de um dispositivo desconhecido, durante a recuperação da conta e quando dados de segurança são alterados. O SMS traz um código numérico curto, normalmente em espanhol, ou em português no site brasileiro, o Mercado Livre. O seu teste deve extrair os dígitos em vez de comparar o texto da mensagem, porque a redação pode mudar a qualquer momento.

Quais países podem fornecer um número de telefone para o Mercado Libre?

O serviço mercado está disponível atualmente em rotas de 201 países. Os que a maioria das equipes procura acompanham a presença do próprio marketplace: Argentina, Brasil, México, Colômbia, Chile, Uruguai, Peru, Equador, Bolívia, Paraguai, Venezuela, Costa Rica, Panamá, Guatemala, El Salvador, Honduras, República Dominicana e Estados Unidos.

A escolha do país não é cosmética. Uma conta registrada em um site regional geralmente espera um número daquele mercado, então escolha a rota que corresponde ao caso de teste. A disponibilidade muda ao longo do dia; consulte GET /api/v1/countries antes de cada execução.

Como funciona a API de código de verificação do Mercado Libre?

Use uma chave Bearer do console de desenvolvedor (prefixo or_live_) em https://otproute.com/api/v1:

1. Consulte o preço, por exemplo GET /api/v1/prices?country=ar&service=mercado.
2. Crie a ativação com POST /api/v1/activations e {"service": "mercado", "country": "ar"}.
3. Digite o número retornado na tela de verificação do Mercado Libre.
4. Receba o evento activation.sms_received ou consulte GET /api/v1/activations/{id}.

Nos webhooks, valide o X-OTPRoute-Signature (HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint), rejeite timestamps antigos e torne o handler idempotente: use o id da ativação como chave para que uma entrega repetida não envie o mesmo código duas vezes. O polling serve a scripts curtos; os webhooks servem ao CI. Planeje a sua matriz de testes de marketplace em torno dos limites por conta: 10 chaves, 5 endpoints de webhook, 300 requisições por minuto. Veja a documentação e a captura de OTP por webhook.

Sem integração? No painel, escolha o Mercado Libre e um país, faça o pedido, cole o número e aguarde o código na tela.

Por que um código do Mercado Libre pode não chegar?

Os marketplaces protegem com cuidado o cadastro e o login, e o Mercado Libre pode recusar alguns números virtuais. A entrega também depende da rota e do momento. Cada ativação tem uma janela de 20 minutos: se nenhum SMS chegar, ou se você cancelar, a cobrança integral volta automaticamente para a sua carteira.

• Espere a janela terminar antes de tentar de novo.
• Tente novamente mais tarde ou troque para outra rota de país que ainda sirva ao seu teste.
• Espace as tentativas em vez de refazer o pedido em loop.

Como reduzir falhas na entrega de OTP aprofunda o assunto.

Quando um Número Dedicado é a melhor opção?

Os números do gateway atendem a uma verificação cada. Se uma conta interna precisar entrar de novo semanas depois, por exemplo um login de operações que o Mercado Libre verifica novamente em dispositivos novos, uma linha persistente evita perder o acesso. Os Números Virtuais Dedicados são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS recebidos no painel e no seu webhook. Servem a contas que já aceitam um número americano ou canadense; para outros mercados, escreva para [email protected] e pergunte o que é possível.

Uso responsável e cobrança

A OTP Route serve para testar o seu próprio produto e operar contas legítimas. Siga os termos do Mercado Libre, mantenha uma conta por pessoa real ou empresa e nunca use números para criar perfis de vendedor duplicados ou resgatar promoções repetidamente. A Política de Uso Aceitável se aplica, e Mercado Libre é marca registrada de seu titular, sem qualquer afiliação implícita.

O pagamento é feito em uma carteira pré-paga em USD, sem mensalidade, recarregada por cartão ou USDT/USDC, com uma fatura em PDF por recarga. Peça ao suporte para colocar uma conta de desenvolvimento em sandbox se quiser códigos simulados do Mercado Libre enquanto monta a integração.

Perguntas frequentes

Posso receber um OTP do Mercado Libre por uma API?

Sim. Crie uma ativação com o serviço mercado e um id de país e leia o código por polling ou pelo webhook activation.sms_received.

Qual país devo escolher para uma conta de teste do Mercado Libre?

Escolha o mercado em que a conta está registrada, como Argentina, Brasil ou México, para que o número corresponda ao que aquele site regional espera.

O Mercado Libre aceita números virtuais?

Nem sempre. Se um código não chegar em 20 minutos, o valor é reembolsado e você pode tentar mais tarde ou por outra rota.

Quanto custa a verificação por SMS do Mercado Libre para testes?

A partir de $0.20 por código; o preço exato depende do país e é mostrado por GET /api/v1/prices antes de você fazer o pedido.

Posso manter o mesmo número para futuros logins no Mercado Libre?

Os números do gateway são de uso único. Um Número Dedicado nos EUA ou no Canadá pode ser mantido enquanto renova, se a conta aceitar esse tipo de número.

Como evito que o meu webhook processe o mesmo código duas vezes?

Guarde o id da ativação quando o primeiro evento chegar e ignore as repetições desse id depois de verificar a assinatura.

Posso abrir várias contas do Mercado Libre com números da OTP Route?

Apenas quando cada conta pertencer a uma pessoa real ou empresa e os termos do Mercado Libre permitirem. Contas duplicadas ou promocionais não são permitidas.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.