Testando fluxos de verificação +27: um checklist para lançamentos na África do Sul

Antes do primeiro pedido +27: uma lista curta de prontidão

Marque estes itens e a sua primeira ativação sul-africana deve passar sem surpresas:

1. Carteira abastecida. Uma carteira pré-paga em USD financia tudo; carregue-a com cartão ou com USDT/USDC. Não há assinatura envolvida.
2. Chave emitida. Gere uma chave Bearer no console do desenvolvedor (ela começa com or_live_). Mantenha chaves separadas para o CI e para o staging, até 10 no total.
3. Webhook registrado. Adicione um endpoint HTTPS e guarde o seu segredo de assinatura. Você pode registrar até cinco.
4. Normalizador de números testado. Alimente-o com entradas no estilo 082 123 4567 e confirme que ele produz +2782... com o 0 inicial removido.
5. Id de serviço confirmado. Obtenha o catálogo em GET /api/v1/services em vez de adivinhar ids.
6. Sandbox opcional. O suporte pode colocar uma conta de desenvolvimento em sandbox, para que números e códigos simulados passem pelo seu código antes de qualquer gasto real.

O guia de testes em CI mostra como encaixar essas peças em um pipeline.

Como armazenar e normalizar números sul-africanos?

A África do Sul usa o prefixo de tronco 0. Um celular escrito no formato local tem dez dígitos, como 082 123 4567, e as faixas de celular geralmente começam com 06, 07 ou 08 nessa forma nacional. No formato internacional, o 0 desaparece: a mesma linha vira +27 82 123 4567, ou +27821234567 sem os espaços, ou seja, nove dígitos depois do código do país.

O bug clássico é um valor armazenado como +270821234567, produzido quando um formulário cola o código do país ao número local sem remover o 0. Normalize na entrada, armazene apenas E.164 e renderize o formato local com espaços exclusivamente para exibição. Se você mesmo envia SMS de saída, a mesma regra mantém consistentes os relatórios de entrega e as consultas de usuários.

Quais serviços podem enviar códigos para um número de verificação da África do Sul?

As rotas populares para za neste momento incluem WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) e Discord. Em todo o catálogo, o país suporta mais de 1.700 serviços e, como o estoque se move ao longo do dia, a API é o lugar para ler a disponibilidade atual.

Por que as equipes escolhem este mercado? Joanesburgo e Cidade do Cabo são polos consolidados de tecnologia e finanças, e muitas empresas usam a África do Sul como base para uma expansão mais ampla pela África Austral. O país tem várias línguas oficiais, incluindo inglês, isiZulu, isiXhosa e africâner, mas a maioria das mensagens de verificação chega em inglês, de modo que o QA de localização tende a se concentrar nas telas ao redor, e não no texto do SMS em si.

Passo a passo: chamando a API OTP da África do Sul a partir do seu ambiente de testes

As requisições vão para https://otproute.com/api/v1 com a sua chave Bearer, até 300 por minuto.

1. GET /api/v1/prices?country=za&service=<id> devolve o preço atual para a combinação desejada.
2. POST /api/v1/activations com {"service": "<id>", "country": "za"} reserva um número +27 e devolve um id de ativação.
3. O seu teste digita o número no aplicativo e dispara o SMS.
4. O evento activation.sms_received chega ao seu webhook. Antes de confiar nele, reconstrua o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare com v1 em X-OTPRoute-Signature e descarte requisições cujo timestamp seja muito antigo.
5. Prefere polling? Leia GET /api/v1/activations/{id} em um intervalo moderado.
6. Execuções abandonadas devem chamar POST /api/v1/activations/{id}/cancel, e GET /api/v1/balance permite que um job pare cedo quando o saldo estiver baixo.

Mais sobre as escolhas de roteamento está em roteamento por país para OTP.

Passo a passo para a equipe de operações usando o painel

Sem necessidade de código: abra o OTP Gateway, escolha África do Sul e o serviço, confira o preço exibido, confirme e cole o número +27 no aplicativo. O SMS aparece na página da ativação assim que chega, e a janela de 20 minutos, com o reembolso automático, funciona exatamente como pela API.

Solução de problemas de códigos sul-africanos travados

Primeiro, a parte do dinheiro: se nenhum SMS chegar em 20 minutos, ou se você cancelar, o valor total volta automaticamente para a carteira. Depois, faça o diagnóstico:

• Paciência primeiro. A velocidade de entrega depende do serviço e da rota, então deixe a ativação seguir o seu curso.
• Política de aceitação. Alguns serviços recusam números virtuais; nesse caso, um reembolso é o comportamento esperado, não uma falha.
• Outro horário ou outra rota. Tente de novo mais tarde, ou use uma rota vizinha como Namíbia ou Botsuana quando o caso de teste permitir.
• Sem martelar. Cancelar e refazer o pedido em um loop apertado raramente ajuda e consome o seu limite de requisições.

Use os números somente para testar o seu próprio produto ou operar as suas próprias contas comerciais, respeite os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Linhas sul-africanas de longo prazo e o modelo de cobrança

Não existe número +27 de longo prazo em autoatendimento. Os Números Dedicados, desde $1.95/month, são oferecidos apenas nos Estados Unidos e no Canadá; as equipes que precisam de uma linha sul-africana permanente podem escrever para [email protected], e a viabilidade depende das regras locais. A cobrança é pay as you go a partir da carteira pré-paga, com uma fatura em PDF enviada por e-mail a cada recarga. Veja os preços para o quadro completo.

Perguntas frequentes

Posso testar o fluxo de cadastro sul-africano do meu aplicativo sem um chip local?

Sim. Peça um número +27 pelo OTP Gateway e leia o código no painel ou pela API. Custa desde $0.20 por código, e só quando o código chega.

Mantenho o 0 inicial ao converter um número sul-africano para E.164?

Não. Retire o 0 de tronco e acrescente o prefixo +27, de modo que 082 123 4567 vire +27821234567.

Qual é o id de país da API para a África do Sul?

É za, que vai na consulta de preço e no corpo JSON ao criar uma ativação +27.

Em que idioma chegam os textos de verificação sul-africanos?

Principalmente em inglês, embora o país tenha várias línguas oficiais. A redação é decidida pelo serviço remetente.

Há reembolso se o código nunca for entregue?

Sim. A ativação fica aberta por 20 minutos e, se nada chegar ou se você cancelar, o valor total volta automaticamente para a sua carteira.

Posso comprar um número sul-africano para manter por meses?

Não em autoatendimento. Os Números Dedicados são um produto dos EUA e do Canadá; para a África do Sul, escreva ao suporte para perguntar, sem promessa de disponibilidade.

Quantos serviços posso verificar com um número +27 na OTP Route?

Mais de 1.700 no retrato mais recente. Consulte o catálogo em tempo real pela API, já que a disponibilidade muda ao longo do dia.

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.