Como levar o código SMS do Mercado Pago para a sua execução de testes

Que problema as equipes resolvem na etapa de telefone do Mercado Pago?

O Mercado Pago, a plataforma de pagamentos e carteira digital do Mercado Libre, faz parte do comércio cotidiano em toda a América Latina. Como a maioria dos apps financeiros, ele associa uma conta a um número de telefone: um código SMS confirma o número no cadastro, e o app pode pedir um código novo quando alguém entra em um dispositivo novo ou recupera o acesso. Para as equipes que constroem em torno dele, como lojistas que integram o checkout, agências que operam a conta de vendedor de um cliente ou engenheiros de QA que testam um marketplace que oferece o Mercado Pago no pagamento, essa etapa do SMS costuma ser a parte incômoda. Colaboradores acabam colocando números pessoais em contas empresariais, ou um caso de teste trava porque a única pessoa que tem o chip certo está fora do ar.

A OTP Route transforma essa etapa em algo que as suas ferramentas conseguem tratar: um número sob demanda para o mercado de que você precisa, com o código entregue aos seus sistemas. Esse é o núcleo da verificação por SMS do Mercado Pago para testes.

Como funciona o fluxo da API de código de verificação do Mercado Pago?

Todas as requisições vão para https://otproute.com/api/v1 com uma chave Bearer (prefixo or_live_) do console de desenvolvedor. O id do serviço é mercado_pago; o id do país é o valor de api_country do seu mercado, por exemplo br para o Brasil ou mx para o México.

1. GET /api/v1/prices?country=br&service=mercado_pago devolve o preço atual e a disponibilidade dessa combinação.
2. POST /api/v1/activations com {"service": "mercado_pago", "country": "br"} devolve o id da ativação e o número.
3. Digite o número na etapa do telefone da conta que você está configurando ou testando.
4. Pegue o código quando activation.sms_received chegar ao seu endpoint, ou consultando GET /api/v1/activations/{id}.
5. Se a execução terminar antes, chame POST /api/v1/activations/{id}/cancel.

Use GET /api/v1/balance como checagem prévia. Cada conta tem 10 chaves, 5 endpoints de webhook e 300 requisições por minuto; o resto está na documentação.

Como o handler de webhook deve tratar os códigos do Mercado Pago?

A entrega por push evita que os executores de teste fiquem girando em loops de polling. Todo evento vem com X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte requisições com timestamps antigos. Depois torne o handler idempotente: guarde o id da ativação e ignore uma segunda entrega do mesmo evento, porque reenvios acontecem. Escute também activation.expired e activation.cancelled, para que o executor libere o seu slot e marque o teste para outra tentativa. Se preferir não hospedar um endpoint, consultar a ativação a cada poucos segundos fica bem dentro do limite de requisições. Como proteger webhooks de OTP traz um checklist mais completo.

De qual país deve vir o número do Mercado Pago?

O serviço mercado_pago está listado em 201 países na OTP Route, mas a escolha útil é quase sempre o mercado ao qual a conta pertence. O Mercado Pago é mais conhecido no Brasil, na Argentina, no México, no Chile, na Colômbia, no Uruguai e no Peru, e é aí que ficam a maioria dos casos de teste. O catálogo também alcança Equador, Bolívia, Paraguai, Costa Rica, Panamá, República Dominicana, Espanha, Portugal e Estados Unidos, entre muitos outros.

Um número do país errado pode falhar na validação ou provocar verificações extras, e não diz nada sobre como os usuários reais daquele mercado vivem o fluxo. Combine com o caso de teste: o onboarding brasileiro recebe um número brasileiro, o onboarding chileno, um chileno.

O que posso fazer pelo painel em vez disso?

Quem não programa chega ao mesmo resultado sem código. Abra o OTP Gateway, escolha o Mercado Pago como serviço, escolha o país e confira o preço exibido antes de pedir. Copie o número no app, solicite o SMS, e o código aparece no cartão da ativação assim que for entregue. O número fica reservado por 20 minutos; se nada chegar, nada é cobrado, pois o valor volta automaticamente para a sua carteira.

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

As plataformas de pagamento são cuidadosas com números de telefone, e um número virtual para o Mercado Pago pode ser recusado em alguns fluxos ou em todos. As rotas também mudam ao longo do dia. Se o código não aparecer:

• Deixe a janela de 20 minutos terminar; o reembolso é automático.
• Evite refazer o pedido em loop acelerado. Espace as tentativas ou volte mais tarde.
• Teste outra rota para o mesmo mercado se uma continuar expirando.
• Confira se o campo de telefone recebeu o número no formato que o app espera.

Quando um fluxo rejeita sistematicamente números virtuais, aceite o resultado e use uma linha real para aquela conta. Como reduzir falhas na entrega de OTP cobre o diagnóstico mais amplo.

Quando um Número Dedicado faz mais sentido?

Um número de uso único trata um código. Uma conta empresarial que pedirá um código novo daqui a meses precisa de um número que você ainda controle. Os Números Dedicados da OTP Route cumprem esse papel nos Estados Unidos e no Canadá, a partir de $1.95/mês: SMS recebidos no painel e no seu webhook (number.sms_received), SMS de saída e chamadas pelo navegador, renovando pela carteira até você liberar a linha. Fora desses dois países não há linha de longo prazo por autoatendimento; escreva para [email protected] e pergunte, sendo que a disponibilidade depende das regras locais. Veja números virtuais para mais detalhes.

Que regras valem ao usar esses números com o Mercado Pago?

O Mercado Pago movimenta dinheiro de verdade, e as suas verificações de identidade existem por boas razões. Um número de telefone da OTP Route não substitui essas verificações e jamais deve ser usado para contorná-las: conclua a verificação de identidade com dados verdadeiros, mantenha uma conta por pessoa real ou empresa e siga os termos do Mercado Pago junto com a Política de Uso Aceitável da OTP Route. A plataforma serve para testar o seu próprio produto e operar as suas próprias contas legítimas, não para abrir contas em volume ou resgatar promoções. A cobrança é por uso (pague conforme consome), a partir de uma carteira pré-paga em USD (cartão ou USDT/USDC, com fatura em PDF a cada recarga), e um sandbox com códigos simulados está disponível sob solicitação para testes de integração. Mercado Pago é marca registrada de seu titular, e a OTP Route não é afiliada a ele.

Perguntas frequentes

Posso receber um OTP do Mercado Pago sem um chip local no Brasil ou no México?

Sim, quando você está testando ou operando a sua própria conta. Peça um número mercado_pago para o país certo e leia o código no painel, pela API ou em um webhook.

Qual é o id do serviço do Mercado Pago na API?

É mercado_pago. Combine-o com o id do país no corpo de POST /api/v1/activations.

O Mercado Pago aceita números virtuais?

Nem sempre. Ele pode rejeitá-los em alguns fluxos, e é por isso que o valor integral é reembolsado quando nenhum código chega em 20 minutos.

Quanto custa um número de telefone do Mercado Pago para verificação?

A partir de $0.20 por código. O preço exato depende do país e é mostrado pela API e pelo painel antes de você fazer o pedido.

Posso usar o mesmo número de uso único para entrar de novo no mês que vem?

Não. Um número de uso único recebe um único código. Contas que precisam de logins repetidos são mais bem atendidas por um Número Dedicado dos EUA ou do Canadá.

O meu pipeline de CI consegue exercitar o fluxo do Mercado Pago sem cobranças reais?

Sim. Peça o modo sandbox para uma conta de desenvolvimento; ele devolve números e códigos simulados pelos mesmos endpoints.

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.