O caminho do desenvolvedor para códigos de verificação suíços (+41)

Quais requisições retornam um código suíço pela API?

A API OTP da Suíça é a mesma superfície enxuta usada em todos os países, com ch como id do país. Autentique-se com uma chave Bearer (prefixo or_live_) criada no console do desenvolvedor; cada conta pode ter até 10 chaves.

1. Obtenha os ids em GET /api/v1/services e GET /api/v1/countries e guarde-os em cache entre as execuções.
2. Consulte GET /api/v1/prices?country=ch&service=<id>. A resposta traz o preço atual e se há uma rota aberta naquele momento.
3. Envie POST /api/v1/activations com {"service": "whatsapp", "country": "ch"} ou o serviço que o seu teste cobre. Guarde o id da ativação retornado.
4. Informe o número +41 no campo de telefone do seu próprio produto.
5. Leia o resultado em GET /api/v1/activations/{id} ou em um webhook; cancele sem deixar pendências com POST /api/v1/activations/{id}/cancel.

Coloque GET /api/v1/balance na etapa de preparação da sua suíte. O limite é de 300 requisições por minuto por conta, o que cobre com folga vários jobs simultâneos fazendo polling em intervalos tranquilos. Referência dos endpoints: documentação.

Polling ou webhooks para ativações +41?

O polling mantém um script rápido simples. Os webhooks passam a valer a pena assim que os testes rodam em paralelo, porque nada precisa ficar em loop enquanto um SMS com destino a Zurique está a caminho.

A OTP Route permite registrar até cinco endpoints; assine cada um em activation.sms_received, activation.expired e activation.cancelled. Verifique cada entrega antes de confiar nela: pegue as partes t e v1 de X-OTPRoute-Signature, calcule o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare em tempo constante e recuse timestamps fora de uma tolerância curta. Baseie o processamento no id da ativação, para que uma entrega repetida seja inofensiva.

Para um estudo mais aprofundado das verificações de assinatura, veja como proteger webhooks de OTP com HMAC.

Como um número suíço deve ficar no seu banco de dados?

No uso doméstico, os números suíços começam com o prefixo de tronco 0, por exemplo um celular escrito como 079 123 45 67. No formato internacional esse zero desaparece: a forma E.164 é +41 79 123 45 67, com nove dígitos após o código do país. As faixas de celular ficam no bloco 07x. Armazene a string canônica +41… e formate apenas para exibição; caso contrário, a deduplicação e as buscas quebram quando uma forma diz 079 e outra +4179.

O idioma é a outra peculiaridade suíça. Com alemão, francês, italiano e romanche como idiomas nacionais, um SMS de verificação pode chegar em qualquer um dos três primeiros, conforme o tratamento de localidade do remetente, e muitos apps simplesmente voltam para o inglês. Se o seu produto localiza por região, um código real +41 é uma forma barata de confirmar que o modelo certo é disparado.

As equipes testam aqui antes de lançar um produto fintech ou de e-commerce no mercado suíço, ao dar suporte a funcionários que gerenciam contas empresariais a partir de Genebra ou Basileia, ou ao validar fluxos transfronteiriços que também envolvem Liechtenstein, que usa o próprio código +423.

Serviços que você pode verificar com um número de verificação da Suíça

O snapshot atual de ch lista Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) e Claude, entre outros. No total, a Suíça conta com mais de 1.700 serviços no OTP Gateway.

Como a disponibilidade muda ao longo do dia, trate essa lista como ponto de partida e consulte os dados ao vivo em tempo de execução. Um harness que verifica os preços primeiro e marca o teste como ignorado quando a rota está fechada produz relatórios muito mais limpos do que um que tenta de novo às cegas.

Como resolver uma ativação suíça que continua vazia

Quando um número +41 nunca recebe nada, passe por estes pontos antes de mexer no código:

• Dê uma chance à janela completa de 20 minutos; algumas plataformas enfileiram as mensagens de saída.
• Verifique se o serviço recusa números virtuais. Vários recusam, e é exatamente para esse caso que existe o reembolso automático.
• Tente de novo após uma pausa, ou use outra rota de serviço, em vez de refazer o pedido em loop apertado.
• Cancele as ativações abandonadas para que o dinheiro volte na hora.

O artigo sobre roteamento de OTP por país explica por que o mesmo app pode se comportar de forma diferente de uma rota de país para outra.

Existe um número suíço de longo prazo?

Não como produto de autoatendimento. Para a Suíça, a OTP Route oferece apenas números de uso único por meio do OTP Gateway.

Os Números Virtuais Dedicados, que você mantém enquanto são renovados, estão limitados aos Estados Unidos e ao Canadá e começam em $1.95/mês. Se você precisa especificamente de uma linha suíça persistente, escreva para [email protected] e descreva o caso de uso; a resposta depende das regras locais e não pode ser prometida de antemão.

Carteira, faturas e sandbox para roteamento de OTP na Suíça

Você paga conforme o uso a partir de uma única carteira pré-paga em USD. Não há mensalidade nem plano a escolher. Recarregue por cartão ou com USDT/USDC, e uma fatura em PDF é enviada por e-mail a cada recarga, o que mantém a contabilidade organizada para entidades suíças que conciliam em francos.

Para o trabalho de integração, peça o modo sandbox em uma conta de desenvolvimento. Ele retorna números e códigos simulados, de modo que todo o caminho da API de verificação por SMS possa ser testado sem gastar saldo da carteira. Use ativações reais apenas para os seus próprios produtos e contas, dentro dos termos de cada serviço e da Política de Uso Aceitável da OTP Route. A página da solução de testes de QA mostra como as equipes incorporam isso às verificações de release.

Perguntas frequentes

Qual id de país a API usa para a Suíça?

A Suíça é ch. As requisições suíças levam esse valor de duas letras em qualquer lugar onde se espera um país, inclusive no corpo da ativação.

Posso testar um fluxo de login suíço sem ter um chip suíço?

Sim. Um número +41 para testes do OTP Gateway recebe o código, que você lê no painel ou pela API.

Devo manter o 0 ao salvar um celular suíço?

Não. O 0 é um prefixo de tronco doméstico; armazene a forma E.164 começando com +41 seguida de nove dígitos.

Em que idioma estará um SMS de verificação suíço?

Depende do remetente: alemão, francês, italiano ou inglês são todos comuns. Extraia o código com um padrão de dígitos em vez de um texto fixo.

Quanto custa um SMS OTP da Suíça?

A partir de $0.20 por código, com o preço exato por serviço retornado por GET /api/v1/prices antes de você fazer o pedido.

O que acontece com o meu dinheiro se nenhum código chegar?

Ele volta para a sua carteira automaticamente quando a janela se encerra ou quando você cancela a ativação.

Liechtenstein é coberto pela rota suíça?

Não, Liechtenstein tem o próprio código de país +423 e a própria página na lista de países, então peça-o separadamente.

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.