Como testar fluxos de cadastro cipriotas com números de verificação +357

Nossa equipe lança no Chipre, mas não tem chips locais. Quais são as opções?

O padrão costuma ser este: um produto entra no ar para clientes em Nicósia, Limassol ou Larnaca, a etapa de telefone do onboarding precisa de cobertura de regressão, e os únicos chips +357 pertencem a dois colegas cansados de encaminhar códigos dos próprios celulares. Chips físicos numa gaveta expiram, se perdem e acabam ligados a contas de teste de que ninguém se lembra.

O roteamento de OTP substitui essa gaveta. O seu harness de testes pede um número cipriota novo a cada execução, espera o código e segue em frente, sem aparelho nenhum. A mesma abordagem serve para uma equipe de operações que precisa verificar uma conta empresarial registrada no Chipre sem entregar o celular particular de alguém. Nosso guia de testes de QA mostra como as equipes encaixam isso em uma suíte existente.

O Chipre é um Estado-membro da UE com um cenário movimentado de software, fintech e transporte marítimo, sendo um primeiro ou segundo mercado europeu comum para empresas que já operam na Grécia ou no Mediterrâneo oriental.

Quais apps podem enviar um código a um número cipriota?

O retrato ao vivo do Chipre lista atualmente mais de 1.500 serviços. Entre os mais pedidos pelas equipes:

• WhatsApp, Viber, Telegram e Signal para mensagens
• Google (Gmail & YouTube), Microsoft & Outlook e LinkedIn para contas de trabalho
• Facebook, Instagram e TikTok para logins sociais
• Uber, Airbnb, Amazon, Netflix e eBay para viagens e comércio

A disponibilidade de cada rota muda ao longo do dia, e é por isso que preços e cobertura são servidos ao vivo, em vez de impressos numa página. Trate a lista acima como ponto de partida e confirme o serviço exato no painel ou pela API antes de montar um teste em torno dele.

Como peço um número +357 pela API de OTP do Chipre?

Crie uma chave no console do desenvolvedor; as chaves começam com or_live_ e vão num cabeçalho Bearer contra https://otproute.com/api/v1. Uma execução típica leva quatro chamadas:

1. GET /api/v1/prices?country=cy&service=viber devolve o preço atual, para que o seu job possa se recusar a prosseguir acima de um orçamento que você definiu.
2. POST /api/v1/activations com {"service": "viber", "country": "cy"} reserva o número e devolve um ID de ativação.
3. O seu teste digita esse número no app em teste e depois faz polling em GET /api/v1/activations/{id} ou espera o webhook activation.sms_received.
4. Se o cenário falhar cedo, POST /api/v1/activations/{id}/cancel o libera e devolve os fundos.

Os webhooks trazem um cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>). O seu receptor deve reconstruir o HMAC-SHA256 de <t>.<raw body> usando o segredo daquele endpoint, comparar com v1 sem saída antecipada e ignorar qualquer requisição cujo timestamp seja antigo. Para planejar a capacidade, uma conta pode ter até 10 chaves e 5 endpoints de webhook, com um teto de 300 requisições por minuto. A documentação da API lista todos os campos.

Quem não é desenvolvedor pode pedir um número de verificação do Chipre?

Pode. A equipe de suporte e os gerentes de contas muitas vezes só precisam de um código, e o painel resolve isso sem tocar na API:

1. Entre na conta e abra o OTP Gateway.
2. Escolha o Chipre e depois o serviço que você está verificando.
3. Confira o preço mostrado, que é o mesmo valor que a API devolveria.
4. Faça o pedido, copie o número +357 para o app e mantenha a aba aberta.
5. O código aparece no cartão da ativação assim que for recebido.

A ativação fica aberta por 20 minutos. Cancele-a pelo mesmo cartão se não precisar mais do código.

O código não chegou. E agora?

Nada se perde: quando a janela de 20 minutos fecha sem SMS, ou quando você cancela, o valor integral volta automaticamente para a sua carteira. Para melhorar a próxima tentativa:

• Deixe a primeira janela correr antes de pedir de novo; requisições sobrepostas para o mesmo serviço raramente ajudam.
• Alguns serviços recusam números virtuais de vez; por isso, um código ausente pode ser uma decisão de política do lado deles, e não um problema de roteamento.
• Tente um pouco mais tarde, ou teste o mesmo fluxo em outra rota de serviço para confirmar que o seu próprio caminho de código funciona.
• Nunca repita o pedido em um laço apertado a partir do CI. Espace as tentativas e limite as novas tentativas por execução.

Nosso artigo sobre como reduzir falhas na entrega de OTP trata de orçamentos de novas tentativas com mais profundidade.

Como armazenar números +357 e em que idioma chegam os códigos?

O Chipre não tem prefixo de tronco; portanto, não há zero inicial para remover. Os números nacionais têm oito dígitos, e os móveis começam com 9. Em E.164, isso vira +357 seguido desses oito dígitos, sem espaços nem pontuação. Os usuários costumam digitar a forma local com um espaço depois dos dois primeiros dígitos; portanto, normalize a entrada removendo espaços em branco e adicionando o código do país antes de comparar ou armazenar.

O grego e o turco são os idiomas oficiais, e o inglês é muito usado nos negócios. Na prática, o texto de um SMS de verificação segue a configuração de idioma do app, então espere texto em inglês ou grego. Faça o seu parser extrair a sequência de dígitos em vez de comparar uma frase fixa, e o mesmo teste sobreviverá a uma troca de localidade.

Existe uma linha cipriota de longo prazo e como funciona a cobrança?

Não existe número de longo prazo self-service para o Chipre. Os Números Dedicados que você mantém mês a mês são um produto dos Estados Unidos e do Canadá, a partir de $1.95/mês, descritos na página de números virtuais. Se a sua equipe precisa de uma linha +357 duradoura, escreva para [email protected]; a disponibilidade depende das regras locais e não é prometida.

A cobrança passa por uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Os fundos entram por cartão ou USDT/USDC, e uma fatura em PDF por e-mail acompanha cada recarga. Para trabalho de integração, peça um sandbox em uma conta de desenvolvimento: ele devolve números e códigos simulados para que o pipeline rode de ponta a ponta sem gastar fundos da carteira. Veja os preços para o modelo atual e lembre que os termos de cada serviço e a Política de Uso Aceitável da OTP Route valem para toda ativação.

Perguntas frequentes

Posso testar o fluxo de cadastro do Chipre do meu app sem um chip cipriota?

Sim. Peça um número +357 no OTP Gateway, digite-o no seu app e leia o código no painel ou pela API. Não é preciso aparelho nem chip local.

Que ID de país a API espera para o Chipre?

Use cy como valor de país nas requisições de preço e de ativação, por exemplo {"service": "whatsapp", "country": "cy"}.

Sou cobrado se um código cipriota não chegar?

Não. Uma ativação cipriota que termina sem SMS, seja por expirar em 20 minutos, seja porque você a cancelou, é creditada integralmente de volta na carteira.

Devo remover um zero inicial dos números cipriotas?

Não há nenhum para remover, porque o Chipre não usa prefixo de tronco. Armazene o número como +357 mais os oito dígitos nacionais.

Posso reutilizar o mesmo número +357 para entrar no mês que vem?

Não. Cada número do OTP Gateway atende a um código de verificação. Para contas que precisam continuar entrando, um Número Dedicado dos EUA ou do Canadá é a melhor opção.

Quanto custa um número de verificação do Chipre?

O preço de um número +357 começa em $0.20 por código, com o valor final definido pelo serviço escolhido. O seu script pode ler o valor atual do Chipre em GET /api/v1/prices, e o painel o exibe ao lado do botão de pedido.

A OTP Route serve para abrir muitas contas?

Não. Ela foi feita para testar o seu próprio produto e operar contas empresariais legítimas. Siga os termos de cada serviço e mantenha uma conta por pessoa ou empresa real.

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.