Como obter códigos de verificação +239 de São Tomé e Príncipe

Por que uma equipe de produto testaria em São Tomé e Príncipe?

As ilhas formam um dos menores mercados da África, mas importam para qualquer produto que atenda o mundo lusófono. Equipes que lançam produtos pela África lusófona, ou que dão suporte a clientes que circulam entre as ilhas, Portugal e Angola, precisam ver se um número +239 passa pelo formulário de cadastro e se os textos em português aparecem corretamente.

O português é a língua oficial, e os textos de verificação de apps internacionais costumam chegar em português ou em inglês, conforme as configurações da conta. Crioulos locais como o forro são amplamente falados, mas raramente aparecem em SMS automatizados.

Há também motivos práticos. ONGs, agências de desenvolvimento e empregadores remote-first com equipe em São Tomé ou na ilha do Príncipe muitas vezes precisam confirmar que o onboarding funciona com números locais, e equipes de fintech que expandem corredores de remessas a partir de Portugal querem provar que um cliente +239 consegue concluir o cadastro. Uma rodada de QA com um número real das ilhas responde a essa pergunta mais rápido do que um chamado de um usuário confuso.

Como um número +239 é escrito e armazenado?

Os números nacionais têm sete dígitos, e os celulares costumam começar com 9. Em E.164 isso vira +239 seguido dos sete dígitos. Números curtos assim confundem validadores que esperam um comprimento mínimo de oito ou mais, então adicione um caso +239 aos seus testes de parsing e normalize espaços ou hifens antes de gravar o valor.

Alguns hábitos mantêm os dados limpos:

• Salve a string canônica +239 e guarde o país detectado em uma coluna própria.
• Remova o prefixo internacional 00239 que um usuário cola de um contato antigo.
• Não complete com zeros os números de sete dígitos para caberem em um campo de tamanho fixo; amplie o campo.
• Inclua ao menos uma fixture +239 nos testes unitários, para que uma mudança futura no validador não a quebre em silêncio.

O que o OTP Gateway oferece para São Tomé e Príncipe?

O catálogo ativo do país reúne mais de 600 serviços. Entre os mais populares estão WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, LinkedIn, Signal, Viber, imo e Amazon.

A cobertura em um mercado pequeno pode diminuir em certos horários. Leia GET /api/v1/prices antes de cada pedido em vez de confiar nos resultados de ontem e, se uma rota estiver vazia, compare com uma rota lusófona próxima, como Cabo Verde, ou com uma maior, como Angola.

Como é o fluxo da API para o id de país st?

1. GET /api/v1/prices?country=st&service=<id> retorna o preço e a disponibilidade em tempo real.
2. POST /api/v1/activations com {"service": "<id>", "country": "st"} reserva um número.
3. Use o número no seu app e depois aguarde activation.sms_received no seu webhook ou faça polling em GET /api/v1/activations/{id}.
4. POST /api/v1/activations/{id}/cancel encerra uma tentativa de que você não precisa mais.

As chamadas vão para https://otproute.com/api/v1 com uma chave Bearer or_live_. Verifique X-OTPRoute-Signature (HMAC-SHA256 de "<t>.<raw body>") e descarte timestamps antigos; proteger webhooks de OTP com HMAC mostra como.

Alguém que não programa também pode usar?

Pode. Depois de se cadastrar com um código por e-mail ou com o Google, abra o OTP Gateway, escolha o serviço, selecione São Tomé e Príncipe e confirme o preço atual. O número aparece na hora e o código surge na mesma tela quando o SMS chega.

Isso serve a um atendente de suporte que reproduz a reclamação de um cliente nas ilhas, ou a um gerente de produto que quer ver uma vez as telas de onboarding em português antes do lançamento. Ative a autenticação em dois fatores TOTP na conta, já que o painel guarda tanto a carteira quanto os códigos recebidos.

E um número de longo prazo, a cobrança e o sandbox?

Não existe número +239 de longo prazo em autoatendimento. Os Números Virtuais Dedicados são um produto dos EUA e do Canadá, a partir de $1.95/mês; para uma linha duradoura nas ilhas, escreva para [email protected], ciente de que as regras locais definem se algo é possível.

Você paga com uma única carteira pré-paga em USD, sem mensalidade, abastecida por cartão ou USDT/USDC, com uma fatura em PDF por recarga. Uma conta sandbox retorna números e códigos simulados para testes de integração. Os detalhes estão em /pricing.

Como a carteira é compartilhada entre todos os países, uma equipe que testa as ilhas junto com Portugal ou o Brasil vê todas essas ativações em um só saldo e em um só conjunto de faturas, o que simplifica a conciliação para o financeiro no fim do mês.

Perguntas frequentes

Posso verificar o cadastro do meu app em São Tomé e Príncipe sem visitar as ilhas?

Sim. Peça um número +239 no OTP Gateway da OTP Route, digite-o no seu app e leia o código no painel ou pela API.

O que faço se o código +239 não chegar?

Dê à ativação os 20 minutos completos e depois tente mais tarde ou com outra rota de serviço. Evite refazer o pedido repetidamente em poucos segundos.

Sou cobrado por uma ativação de São Tomé e Príncipe que falhou?

Não. Se o SMS não chegar antes de a janela fechar, ou se você cancelar, o valor integral volta para a sua carteira.

Por que um app recusa meu número de verificação de São Tomé e Príncipe?

Alguns serviços recusam números virtuais. Isso foge ao controle da OTP Route, e é por isso que as ativações sem uso são reembolsadas.

O texto de verificação virá em português?

Muitas vezes, já que o português é o idioma oficial, mas cada app escolhe sua própria redação e pode usar inglês.

A API de OTP de São Tomé e Príncipe tem limite de requisições?

Cada conta pode fazer 300 requisições por minuto e ter até 10 chaves de API e 5 endpoints de webhook.

Posso rodar isso em um job de CI?

Sim, pedindo uma ativação por execução. A página de testes de QA mostra como as equipes organizam isso.

Quais usos a OTP Route permite?

Testar o seu próprio produto e operar contas empresariais legítimas, dentro dos termos de cada serviço e da 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.