Como escolher a rota certa para códigos de verificação ucranianos (+380)

Os casos de teste ucranianos precisam de um número de uso único ou de uma linha de longo prazo?

Comece por esta pergunta, porque ela decide todo o resto. Um número de uso único do OTP Gateway recebe um código de verificação e depois se encerra. Uma linha de longo prazo é algo que você mantém e com a qual faz login de novo meses depois.

Para a Ucrânia a resposta é simples: o OTP Gateway é a opção de autoatendimento. Não existe número dedicado ucraniano em autoatendimento. Os Números Dedicados de longo prazo existem apenas nos EUA e no Canadá, a partir de $1.95/mês, e servem para contas de staging que precisam continuar fazendo login ou para uma linha compartilhada de recuperação da equipe. Se você precisa especificamente de uma linha +380 duradoura, escreva para [email protected]; a disponibilidade depende das regras locais e não é prometida.

Portanto, a divisão prática é: use um número +380 de uso único para o cadastro e para o QA da etapa de telefone e, se uma conta de teste precisar sobreviver a uma nova verificação, avalie se uma linha dos EUA ou do Canadá serve ao teste. A comparação em números temporários vs dedicados detalha as vantagens e desvantagens.

Por que as equipes de engenharia testam com números +380?

A Ucrânia tem uma grande comunidade de engenharia de software, e muitas equipes internacionais de produto incluem desenvolvedores e testadores ucranianos. Além disso, algumas situações aparecem repetidamente:

• QA em ucraniano: o ucraniano é o idioma oficial, e as equipes que localizam o onboarding querem ver a etapa real do telefone com texto cirílico ao redor.
• Usuários da diáspora: pessoas com números +380 hoje vivem na Polônia, na Alemanha e em outros países europeus, então um app lançado em outro lugar ainda encontra números ucranianos no cadastro.
• Fluxos centrados em mensagens: Telegram e Viber são muito usados na Ucrânia, o que os torna alvos de teste comuns para produtos que se integram a qualquer um dos dois.

O próprio texto de verificação pode chegar em ucraniano, inglês ou outro idioma, dependendo do serviço e das configurações da conta, então extraia os dígitos com um padrão em vez de procurar palavras fixas.

Como normalizar os números +380?

No uso doméstico, os números ucranianos são escritos com um 0 de tronco seguido de nove dígitos, por exemplo no formato 0XX XXX XX XX. Na forma internacional o zero é descartado: +380 mais o número nacional de nove dígitos. Observe que o próprio código do país termina em 0, o que confunde alguns validadores escritos à mão.

Diretrizes:

• Persista apenas a string E.164; formate com espaços ou com o zero de tronco apenas na hora de exibir.
• Se um usuário digitar 0… depois de escolher +380, remova exatamente um zero inicial.
• Fique de olho em +3800…, sinal de que o prefixo de tronco não foi removido.
• Valide o tamanho com uma biblioteca mantida, em vez de regexes copiadas de outro lugar.

Quais serviços um número de verificação da Ucrânia pode receber?

O snapshot ao vivo conta mais de 1.500 serviços para a Ucrânia. Entre os populares estão Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Discord, LinkedIn, Microsoft & Outlook, Uber, ChatGPT (OpenAI) e Claude.

O que é oferecido muda ao longo do dia, então trate isto como exemplo e deixe a API dizer o que está disponível no momento.

Como as chamadas da API OTP para a Ucrânia se encaixam?

As requisições de números +380 vão para https://otproute.com/api/v1, assinadas com uma chave Bearer or_live_ gerada no console do desenvolvedor. O id de país da Ucrânia é ua.

Uma sequência limpa: consulte os ids com GET /api/v1/services e GET /api/v1/countries; leia custo e disponibilidade em GET /api/v1/prices?country=ua&service=<id>; confirme o saldo com GET /api/v1/balance; depois envie POST /api/v1/activations com {"service": "viber", "country": "ua"}. A resposta traz o número +380 e um id de ativação.

Para a entrega, escolha entre fazer polling em GET /api/v1/activations/{id} e um webhook inscrito em activation.sms_received, activation.expired e activation.cancelled. Todo webhook traz X-OTPRoute-Signature: t=<unix>,v1=<hex>; verifique-o como HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, rejeite timestamps vencidos e processe cada id de ativação uma única vez. Uma conta permite 10 chaves, 5 endpoints e 300 requisições por minuto. Os detalhes completos estão na documentação.

Qual é o caminho pelo painel para quem não é desenvolvedor?

A equipe de suporte e de growth pode dispensar a API por completo. Abra o OTP Gateway no painel, selecione a Ucrânia e o serviço, confira o preço exibido e faça o pedido. Digite o número +380 no app, solicite o SMS, e o código aparece na página da ativação quando chegar.

E se o código não chegar, e como funciona a cobrança?

Uma ativação fica aberta por 20 minutos, e você só paga quando um código chega. Se a janela fechar vazia, ou se você chamar POST /api/v1/activations/{id}/cancel, o valor integral volta para a carteira.

Se um código estiver faltando, espere a janela terminar e depois tente de novo mais tarde ou com outra rota de serviço. Verifique se o serviço rejeita números virtuais e não dispare pedidos repetidos em loop rápido.

Os fundos vêm de uma única carteira pré-paga em USD, sem mensalidade. Pagamentos por cartão e em USDT/USDC servem para recarregar, e uma fatura em PDF chega à sua caixa de entrada depois de cada um. Mediante pedido, uma conta de desenvolvimento pode rodar em modo sandbox, com números e códigos simulados, útil ao configurar pipelines de CI. A OTP Route é para seus próprios produtos e contas legítimos: siga os termos de cada serviço e a Política de Uso Aceitável.

Perguntas frequentes

Posso receber códigos SMS OTP da Ucrânia sem um chip ucraniano?

Sim. Peça um número +380 no OTP Gateway e leia o código no painel ou pela API.

Qual id de país a OTP Route usa para a Ucrânia?

Use ua nas consultas de preço e no corpo de POST /api/v1/activations.

O 0 de tronco faz parte de um número +380?

Só na discagem doméstica. Em E.164 você armazena +380 seguido de nove dígitos, sem zero extra.

Quanto custa um número de verificação da Ucrânia?

Os preços começam em $0.20 por código, e a API retorna o valor exato ao vivo para cada serviço.

Posso manter um número +380 para logins futuros?

Não existe linha ucraniana de longo prazo em autoatendimento. Os Números Dedicados são um produto dos EUA e do Canadá; escreva para [email protected] para perguntar sobre qualquer outra opção.

Vou perder dinheiro se o Telegram nunca enviar o código?

Não. Sem um código dentro da janela de 20 minutos, a cobrança volta automaticamente para a sua carteira.

Posso testar de ponta a ponta no CI o meu onboarding em ucraniano?

Sim, chamando a API a partir da sua suíte de testes, e uma conta sandbox permite ensaiar o fluxo antes com códigos simulados.

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.