Testes de verificação turca em números +90, passo a passo

Checklist prévio: o que preparar antes de pedir um número +90?

Uma lista curta evita ativações desperdiçadas quando um plano de testes turco entra em andamento:

1. Consulte o id do serviço do app com GET /api/v1/services e confirme o id de país tr com GET /api/v1/countries.
2. Chame GET /api/v1/prices?country=tr&service=<id> para ver quanto o par custa agora e se está disponível.
3. Verifique se a carteira cobre a execução com GET /api/v1/balance.
4. Registre um endpoint de webhook (uma conta pode ter até cinco) e mantenha o segredo fora do controle de versão.
5. Configure sua biblioteca de validação de telefone para a região TR e decida como a interface vai exibir o número ao testador.
6. Carregue o locale turco no ambiente de testes, porque bugs de maiúsculas e minúsculas em strings costumam aparecer aqui primeiro.

Por que o 0 inicial atrapalha a validação de telefones turcos?

Dentro da Turquia, as pessoas escrevem números de celular com um prefixo de tronco, como em 0 5XX XXX XX XX. Internacionalmente o zero some: a forma canônica é +90 seguido de um número nacional de dez dígitos, e os celulares começam com 5 depois do código do país.

Formulários que aceitam os dois estilos precisam de uma etapa de normalização. Remova espaços e pontuação, descarte um único 0 inicial quando a região for TR, acrescente +90 e salve o resultado em E.164 (+905…). Nunca guarde o zero do tronco no valor armazenado, ou o mesmo testador parecerá dois usuários diferentes no seu banco de dados. Exiba o número de volta no estilo nacional se os seus usuários turcos esperarem isso.

Como será um SMS de verificação turco para o seu parser?

O turco é o idioma oficial, e os remetentes locais escrevem seus códigos em turco, com letras como ç, ş, ğ, ı, ö e ü. Apps internacionais costumam seguir o idioma do dispositivo ou da conta. De qualquer forma, extraia o código com um padrão de dígitos, em vez de procurar as palavras ao redor.

O locale turco também esconde uma armadilha conhecida de software: passar um i minúsculo para maiúsculo gera um İ com ponto, e passar I para minúsculo gera um ı sem ponto. Código que compara strings com conversão de caixa sensível ao locale pode quebrar verificações de login ou de e-mail para usuários turcos. Uma rodada de testes com +90 é um bom momento para pegar isso, junto com máscaras de entrada de tamanho correto e mensagens de erro traduzidas. O guia de verificação para apps móveis cobre verificações relacionadas.

Quais apps podem enviar códigos para um número de verificação da Turquia?

O snapshot atual para tr inclui WhatsApp, Telegram, Instagram, TikTok, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Netflix, AliExpress, Discord, ChatGPT (OpenAI) e Amazon. No total, a rota turca alcança mais de 1.800 serviços.

As equipes pedem números aqui para lançar um produto na Turquia, para checar a localização antes de uma campanha de marketing ou para atender clientes de língua turca que vivem em outras partes da Europa. Como a capacidade varia ao longo do dia, confie na lista de preços ao vivo em vez de uma lista fixa na configuração dos seus testes.

Como solicitar e ler um OTP da Turquia pela API?

A sequência de chamadas é curta. Envie POST /api/v1/activations com {"service": "<id>", "country": "tr"} e uma chave Bearer com prefixo or_live_. Informe o número +90 retornado no app em teste. Quando o SMS chegar, a OTP Route dispara activation.sms_received para o seu endpoint; se a janela fechar antes, você recebe activation.expired, e uma interrupção manual gera activation.cancelled.

Antes de confiar em qualquer evento, recalcule a assinatura a partir do cabeçalho X-OTPRoute-Signature: HMAC-SHA256 do timestamp, um ponto e o corpo bruto da requisição, com o segredo do endpoint como chave. Rejeite qualquer coisa com timestamp antigo e trate entregas repetidas para o mesmo id de ativação como um único evento. O polling em GET /api/v1/activations/{id} é a alternativa para ambientes sem HTTP de entrada. O artigo sobre captura de OTP por webhook e o hub para desenvolvedores aprofundam o assunto.

Prefere clicar a programar? Use o painel

Colegas não técnicos seguem a mesma lógica no navegador. Entre na conta, adicione saldo, selecione o serviço e a Turquia e copie o número +90 para o app. O SMS recebido aparece no cartão da ativação. Cada número temporário vale para um código dentro de uma janela de 20 minutos.

E se o código turco nunca aparecer?

• Dê os 20 minutos completos antes de concluir que falhou.
• Confirme se o app aceita números virtuais; alguns os recusam, e o reembolso automático existe para esse caso.
• Tente de novo um pouco mais tarde, ou por outra rota de serviço quando o seu teste permitir.
• Espaçe as novas tentativas em vez de fazer pedidos em loop rápido.

Um pedido que termina sem código não custa nada, pois o valor total volta para a carteira.

Cobrança, sandbox e números de longo prazo

A OTP Route funciona com uma carteira pré-paga em USD, sem plano para escolher. Recargas por cartão e em USDT/USDC são aceitas, e cada uma gera uma fatura em PDF por e-mail. Desenvolvedores podem pedir que uma conta de desenvolvimento seja mudada para sandbox, que retorna números e códigos simulados para testes de ponta a ponta sem gastar saldo.

Não existe número turco de longo prazo em autoatendimento. Equipes que precisarem de um podem escrever para [email protected]; a resposta depende da regulamentação local. Para linhas que você mantém e renova, os Números Dedicados são oferecidos nos Estados Unidos e no Canadá a partir de $1.95/mês.

Perguntas frequentes

Posso verificar o cadastro turco do meu app sem um chip turco?

Sim. Um número temporário +90 do OTP Gateway recebe o código, que você lê no painel ou pela API.

Devo armazenar números turcos com o 0 inicial?

Não. Armazene em E.164 como +90 mais o número nacional de dez dígitos, e só acrescente o 0 do tronco ao exibir um formato doméstico.

Qual é o id de país da Turquia na API?

É tr. Informe-o no campo country de POST /api/v1/activations e na consulta de preços.

Quanto custa um número +90 para testes?

As ativações turcas começam em $0.20 por código, e cada app tem sua própria tarifa. O painel e GET /api/v1/prices mostram o valor antes de você pedir.

O que acontece se o código não for entregue?

Se nenhum SMS chegar em 20 minutos, ou se você cancelar a ativação, o valor total é devolvido à sua carteira.

Posso manter um número turco para logins futuros?

Não em autoatendimento. Escreva para [email protected] para perguntar, lembrando que a disponibilidade depende das regras locais.

Existem regras sobre como os números podem ser usados?

Sim. Os números turcos servem para testar e operar produtos e contas que pertencem a você; os termos de cada app continuam valendo, assim como a Política de Uso Aceitável da OTP Route.

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.