Como tirar os códigos de verificação da Shopee dos telefones pessoais

Por que uma equipe precisaria de números da Shopee que ninguém possui pessoalmente?

Imagine uma equipe criando uma integração com um marketplace: sincronização de pedidos, uma ferramenta de devoluções ou um aplicativo de loja. O QA precisa de uma conta de comprador em um mercado específico da Shopee para percorrer o checkout e confirmar que a integração se comporta bem. Alguém recorre ao próprio telefone, e agora uma conta de teste fica presa ao chip de um funcionário em um país.

As agências que montam lojas para clientes enfrentam o mesmo problema, assim como as equipes de produto que preparam o lançamento em um novo mercado do Sudeste Asiático. Um número virtual para a Shopee mantém essas verificações longe dos telefones privados e permite escolher o país de que o teste realmente trata. A página de marketplaces descreve como as equipes desse setor usam a OTP Route.

Quando a Shopee pede um código por telefone?

A Shopee vincula as contas de perto a um número de telefone, e um código único por SMS costuma aparecer nestes pontos:

• Cadastro com número de telefone no aplicativo ou no site para compradores.
• Login por código, ou entrada em um aparelho que a conta ainda não usou.
• Redefinição de senha e recuperação quando a senha é perdida.
• Alterações sensíveis, como editar o telefone, o e-mail ou os dados de recebimento.
• Contas de vendedor, que passam por verificação de telefone quando uma loja é criada.

Os passos exatos diferem entre os sites de cada país da Shopee e mudam com o tempo, então trate isto como o padrão geral, e não como um regulamento fixo.

Quais países podem receber um código da Shopee e por que isso importa?

A rota da Shopee está listada em 197 países, incluindo Indonésia, Malásia, Filipinas, Vietnã, Tailândia, Singapura, Taiwan, Brasil, México, Colômbia, Chile, Índia, Estados Unidos, Reino Unido e Austrália.

A Shopee opera lojas separadas por mercado, e cada uma geralmente espera um número de telefone do próprio país. Portanto, escolha o país que corresponde à conta que você está testando: um teste da loja da Malásia pede um número malaio, e não qualquer número que por acaso seja barato. Combinar com o mercado também mantém o teste realista, porque idioma, moeda e etapas de onboarding seguem a loja.

Como funciona a API de código de verificação da Shopee?

Use a URL base https://otproute.com/api/v1 com uma chave Bearer com o prefixo or_live_. Consulte o preço do seu mercado com GET /api/v1/prices?country=my&service=shopee e depois crie a ativação com POST /api/v1/activations e o corpo {"service": "shopee", "country": "my"}. Os ids de país vêm de GET /api/v1/countries.

Para a entrega, você tem duas opções:

• Webhook: assine activation.sms_received, além de activation.expired e activation.cancelled. Verifique o cabeçalho X-OTPRoute-Signature calculando o HMAC-SHA256 de "<t>.<raw body>" com o segredo do seu endpoint, rejeite timestamps vencidos e torne o handler idempotente registrando cada id de ativação uma só vez.
• Polling: chame GET /api/v1/activations/{id} em intervalos até o código aparecer ou a ativação terminar.

O artigo sobre captura de OTP por webhook mostra um receptor pronto para produção.

Passo a passo no painel para vendedores e equipes de operações

Nem todo mundo precisa da API. No painel:

1. Cadastre-se com e-mail e um código de seis dígitos, ou com o Google.
2. Recarregue a carteira por cartão ou com USDT/USDC.
3. Abra o OTP Gateway, escolha a Shopee e o país e confira o preço ao vivo.
4. Faça o pedido e digite o número no campo de telefone da Shopee.
5. Leia o código quando ele aparecer ao lado do número.

Cada ativação tem uma janela de 20 minutos. Você só paga se o código chegar; caso contrário, o valor volta para a carteira por conta própria.

Por que um código da Shopee pode não chegar?

Algumas coisas podem atrapalhar. A Shopee pode recusar números virtuais em alguns mercados ou fluxos, e o reembolso automático existe para essa situação. As rotas também podem estar ocupadas em certos horários, já que a entrega depende do serviço e da rota.

O que tentar:

• Deixe a janela correr os 20 minutos completos antes de desistir.
• Faça o pedido de novo mais tarde, ou tente a rota de outro país se o seu teste permitir.
• Espace as novas tentativas em testes automatizados; refazer o pedido em um loop apertado raramente ajuda.

Para uma lista de solução de problemas mais completa, voltada a fluxos de marketplace, leia como reduzir falhas na entrega de OTP.

Quando um Número Dedicado serve melhor e quais são as regras básicas?

Um número descartável serve para uma única verificação. Uma conta de comprador de staging que precisa entrar de novo na semana que vem, ou um login operacional compartilhado que precisa de recuperação, é mais bem atendida por um Número Dedicado que você mantém enquanto ele é renovado. Eles estão disponíveis na hora nos Estados Unidos e no Canadá a partir de $1.95/mês, com SMS recebidos no painel e no seu webhook. Veja os detalhes em números virtuais.

Use a OTP Route apenas para testar e operar suas próprias contas e produtos legítimos. Siga os termos da Shopee, mantenha uma conta por pessoa ou empresa reais e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica. A Shopee é uma marca registrada de seu proprietário, e a OTP Route não é afiliada a ela.

Perguntas frequentes

Qual é o id de serviço da Shopee na API?

É shopee. Combine-o com um id de país, por exemplo {"service": "shopee", "country": "id"} para a Indonésia.

Posso receber um OTP da Shopee para um mercado em que não estou fisicamente?

Sim, se esse país estiver na rota. Peça um número do mercado cuja loja você está testando e leia o código remotamente.

A Shopee aceita qualquer número virtual?

Não. A Shopee pode rejeitar alguns números virtuais, e por isso uma ativação que não recebe código é reembolsada integralmente.

Qual número de telefone da Shopee devo usar em uma conta de teste de longa duração?

Se a conta precisa entrar de novo mais tarde, um Número Dedicado dos EUA ou do Canadá que você mantém é melhor do que uma ativação descartável.

A verificação por SMS da Shopee para testes é compatível com CI?

Sim. Crie ativações pela API, receba os códigos por webhook assinado ou polling e peça uma conta sandbox para ensaiar sem gastar fundos.

Quanto custa um código da Shopee?

A partir de $0.20 por código; o preço exato depende do país e é retornado ao vivo por GET /api/v1/prices.

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.