Como testar fluxos de verificação +268 sem chip em Mbabane

Por que é tão difícil testar de fora um cadastro +268?

Essuatíni é um mercado pequeno, e esse é justamente o problema para equipes distribuídas. Seu produto talvez já atenda clientes em Manzini ou Mbabane por meio de um lançamento na África Austral, mas ninguém no QA tem um chip local, o roaming não é confiável para automação, e pedir a um colega da região que encaminhe códigos por chat não escala além de poucas execuções.

O resultado costumeiro é que o caminho +268 no campo de telefone nunca é exercitado de ponta a ponta. Regras de validação, seletores de país e modelos de SMS do reino seguem para produção sem teste, e o primeiro usuário real vira o caso de teste. A OTP Route fecha essa lacuna ao dar ao teste um número de verificação real de Essuatíni para um código e devolver esse código ao seu código.

Quais serviços podem receber códigos em uma rota de Essuatíni?

O OTP Gateway lista atualmente mais de 900 serviços para Essuatíni. Entre os populares no panorama de hoje estão WhatsApp, Facebook, Google (Gmail & YouTube), Instagram, TikTok, Signal, Microsoft e Outlook, LinkedIn, Uber, Amazon, imo, Netflix e ChatGPT (OpenAI).

A disponibilidade em qualquer rota muda ao longo do dia, conforme os nossos parceiros de operadora adicionam e retiram capacidade, então trate essa lista como ponto de partida. A resposta em tempo real sempre vem de GET /api/v1/services e GET /api/v1/countries, e o painel mostra o mesmo quadro antes de você comprometer fundos.

Como funciona o fluxo da API OTP de Essuatíni no código?

Crie uma chave Bearer (prefixo or_live_) no console do desenvolvedor e depois chame a URL base https://otproute.com/api/v1. Uma etapa de teste típica fica assim:

1. Chame GET /api/v1/prices?country=sz&service=whatsapp para ler o preço em tempo real dessa combinação.
2. Envie POST /api/v1/activations com um corpo JSON indicando o serviço e sz como país. A resposta traz o id de ativação e o número +268.
3. Digite esse número no formulário de cadastro que o seu teste está conduzindo.
4. Aguarde o webhook activation.sms_received ou faça polling em GET /api/v1/activations/{id} até o código aparecer.
5. Se o cenário for abandonado, chame POST /api/v1/activations/{id}/cancel para que a carteira seja creditada na hora.

As requisições de webhook trazem o cabeçalho X-OTPRoute-Signature. Recalcule o HMAC-SHA256 sobre o timestamp e o corpo bruto com o segredo do seu endpoint, rejeite timestamps antigos e identifique cada evento pelo id da ativação, para que novas tentativas sejam inofensivas. O guia de captura por webhook percorre um handler completo, e a referência da API lista todos os endpoints.

O que os engenheiros precisam saber sobre números de telefone de Essuatíni?

Essuatíni usa o código de país +268 com números nacionais de oito dígitos e sem prefixo de tronco, então não há zero inicial para remover. Isso torna a normalização mais simples que em muitos mercados: guarde o valor em E.164 como +268 seguido dos oito dígitos e rejeite entradas com quantidade diferente de dígitos antes que cheguem ao seu provedor de SMS.

Os idiomas oficiais são o siSwati e o inglês. As plataformas internacionais normalmente enviam os textos de verificação para esse mercado em inglês, o que mantém previsíveis as regex de extração de código, mas os seus próprios modelos podem ser localizados, então faça asserções sobre os dígitos, e não sobre o texto ao redor. As equipes costumam testar aqui quando um lançamento na África Austral inclui o reino ao lado da África do Sul, ou quando a equipe de operações regional precisa de contas empresariais ligadas a um número local.

E se o código +268 nunca aparecer?

Rotas pequenas podem ser mais silenciosas que as grandes, então planeje-se para uma ativação vazia ocasional:

• Deixe a janela de 20 minutos correr. Alguns serviços enfileiram as mensagens antes de enviá-las.
• Verifique a aceitação. Certas plataformas recusam números virtuais em algumas rotas; é por isso que uma ativação não utilizada é reembolsada integralmente.
• Tente mais tarde ou troque de rota. Tente de novo depois de uma pausa, ou teste o mesmo fluxo em uma rota vizinha, como a África do Sul.
• Evite loops apertados. Refazer o pedido logo após uma falha raramente ajuda e consome tempo de teste.

O checklist de falhas de entrega traz mais diagnósticos.

Posso manter um número de Essuatíni de longo prazo?

Não por autoatendimento. A OTP Route oferece Dedicated Virtual Numbers apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, com SMS de entrada, SMS de saída e chamadas pelo navegador. Não existe linha +268 de longo prazo em autoatendimento. Se a sua equipe de operações precisar de uma, escreva para [email protected] e o time verificará o que as regras locais permitem; a disponibilidade não é garantida. Para logins repetidos em uma conta de staging, uma linha dedicada dos EUA ou do Canadá costuma ser o substituto prático.

Como é cobrado o roteamento de OTP para Essuatíni?

Os gastos com testes +268 saem de um único saldo pré-pago em USD; nada é cobrado mensalmente e não há faixas para comparar. Pagamentos com cartão e stablecoins USDT/USDC financiam o saldo, e cada recarga dispara uma fatura em PDF por e-mail para os registros financeiros. Você só é cobrado quando um código é entregue. Para o trabalho de integração, peça ao suporte para colocar uma conta de desenvolvimento em sandbox, que retorna números e códigos simulados para que a sua suíte de CI rode sem tocar nos fundos da carteira. Os detalhes completos estão na página de preços. Siga os termos de cada serviço; a Política de Uso Aceitável da OTP Route se aplica a toda ativação.

Perguntas frequentes

Posso testar o cadastro do meu app em Essuatíni sem um chip local?

Sim. Peça uma ativação para o país sz, digite o número +268 no seu formulário e leia o código no painel, por polling ou por webhook.

Os números de Essuatíni têm um zero inicial a remover?

Não. Essuatíni não tem prefixo de tronco, então a forma E.164 é simplesmente +268 seguido do número nacional de oito dígitos.

Quanto custa um número de verificação de Essuatíni?

Os códigos começam em $0.20 por código; o valor exato de cada serviço é retornado por GET /api/v1/prices e exibido no painel antes de você pedir.

Em que idioma estará o texto do OTP?

A maioria dos serviços internacionais envia em inglês para esse mercado, embora a redação varie conforme a plataforma. Extraia o código numérico em vez de comparar frases fixas.

Perco o dinheiro se o SMS falhar?

Não. Se nenhum código chegar em 20 minutos, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira.

Qual rota devo tentar se Essuatíni estiver silenciosa?

Muitas equipes recorrem à África do Sul ou a Moçambique para cobertura regional enquanto a rota +268 se recupera.

Posso rodar esses testes no CI sem gastar fundos?

Sim. Uma conta de desenvolvimento pode ser movida para sandbox sob solicitação, retornando números e códigos simulados para testes de pipeline de ponta a ponta.

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.