Automatizando a verificação por SMS +260 em testes de cadastro na Zâmbia

Quais endpoints uma integração da API OTP da Zâmbia chama?

A integração é uma curta cadeia de chamadas HTTPS para https://otproute.com/api/v1, cada uma com Authorization: Bearer e uma chave com o prefixo or_live_. O id do país da Zâmbia é zm.

• GET /api/v1/countries e GET /api/v1/services: dados de referência, que podem ser guardados em cache por um dia.
• GET /api/v1/prices?country=zm&service=<id>: preço ao vivo e se aquela rota pode aceitar um pedido agora.
• POST /api/v1/activations com {"service": "whatsapp", "country": "zm"}: retorna o id da ativação e um número +260.
• GET /api/v1/activations/{id}: status e, depois de recebido, o código.
• POST /api/v1/activations/{id}/cancel: devolve o número antes do prazo.
• GET /api/v1/balance: execute-o primeiro para que uma suíte de testes pare rápido diante de uma carteira vazia.

Gere as chaves no console do desenvolvedor, até 10 por conta; uma por ambiente é um padrão organizado. O limite da conta é de 300 requisições por minuto. Os esquemas completos estão na documentação da API.

Como escrever o webhook que recebe os códigos +260?

O polling funciona, mas, quando várias ativações rodam ao mesmo tempo, um webhook é mais limpo. Adicione até 5 endpoints no console do desenvolvedor e assine activation.sms_received, activation.expired e activation.cancelled.

Cada requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Monte a string <t>.<raw body>, calcule o HMAC-SHA256 com o segredo do endpoint e compare com v1 em tempo constante. Use os bytes brutos como recebidos, recuse timestamps com mais de poucos minutos e guarde os resultados pelo id da ativação, para que uma entrega repetida não mude nada. Responda rapidamente com um 2xx e faça o trabalho lento depois. Nosso passo a passo sobre como proteger webhooks de OTP com HMAC traz mais detalhes, e testes de SMS OTP em pipelines de CI mostra onde isso se encaixa em um build.

De quais serviços um número de verificação da Zâmbia pode receber códigos?

O snapshot ao vivo coloca a Zâmbia com mais de 1.100 serviços. Entre eles: WhatsApp, Facebook, Google (Gmail & YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft & Outlook, Amazon e Netflix. Como as rotas mudam de hora em hora, deixe o endpoint de preços informar ao seu código o que está aberto antes de fazer o pedido.

Formato dos números da Zâmbia e os idiomas em que os códigos chegam

Os números da Zâmbia são discados no âmbito doméstico com um 0 de tronco, seguido de nove dígitos. No formato internacional o zero some, resultando em +260 seguido de nove dígitos. Normalize tudo para essa forma E.164 antes de salvar e garanta que o seu campo de entrada aceite tanto o estilo local que os usuários realmente digitam quanto o internacional.

O inglês é o idioma oficial, e idiomas como bemba, nianja, tonga e lozi são amplamente falados. O SMS de verificação normalmente chega em inglês, o que simplifica o parsing, mas ainda assim faça a correspondência pelos dígitos para que uma mudança de redação do remetente não quebre os seus testes.

As equipes testam na Zâmbia quando se expandem pela África Austral, criam onboarding para produtos de dinheiro móvel ou de crédito, ou atendem clientes a partir de um centro regional de operações. A página de onboarding fintech trata desse cenário.

Dá para fazer a mesma coisa pelo painel?

Sim, e é prático para verificações pontuais. Faça login, abra o OTP Gateway, escolha o serviço e a Zâmbia, olhe o preço exibido e faça o pedido. Informe o número +260 no app; o código aparece no painel quando chegar. Cancele uma ativação que você não quer mais e o valor dela volta para a carteira.

E se o código não chegar, e quando uma linha dedicada é melhor?

As ativações duram 20 minutos e você só paga quando o código chega. Se a janela expirar ou você cancelar, o valor integral volta automaticamente. Alguns serviços recusam números virtuais, e é por isso que existe o reembolso. Quando um código +260 demora: espere a janela terminar, tente de novo mais tarde ou por outra rota de serviço, confira se o serviço aceita números virtuais e evite refazer o pedido em loop apertado.

Para uma conta que precisa fazer login de novo ou recuperar o acesso mais tarde, um número de uso único é a ferramenta errada. Os Números Virtuais Dedicados cumprem esse papel, mas apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês. A OTP Route não tem linha zambiana de longo prazo em autoatendimento; se você tem uma necessidade real, escreva para [email protected], lembrando que as regras locais decidem e nada é garantido.

Use os números apenas para os seus próprios produtos e contas legítimos, siga os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Como uma integração com a Zâmbia é cobrada e testada com segurança?

Uma única carteira pré-paga em USD financia tudo; não há mensalidade nem plano. Recarregue por cartão ou USDT/USDC e receba uma fatura em PDF por e-mail a cada vez. Durante o desenvolvimento, peça o modo sandbox para a sua conta de desenvolvimento: números e códigos simulados permitem ensaiar todo o caminho do roteamento de OTP sem gastar saldo da carteira. Os valores atuais estão na página de preços.

Perguntas frequentes

Qual id de país a OTP Route usa para a Zâmbia?

zm, como em POST /api/v1/activations com {"service": "telegram", "country": "zm"}.

Posso receber códigos SMS OTP da Zâmbia sem um chip zambiano?

Sim. O OTP Gateway fornece um número +260 para testes, e o código chega a você no painel, por webhook ou por polling.

Como armazeno corretamente os números +260?

Descarte o 0 de tronco doméstico e salve +260 mais nove dígitos em E.164. Formate para exibição separadamente.

O dinheiro é reembolsado se o WhatsApp ou outro serviço rejeitar o número?

Sim. Quando nenhum código chega em 20 minutos, ou você cancela, o valor é creditado de volta na sua carteira automaticamente.

Posso manter um número zambiano para logins futuros?

Não por autoatendimento. Os números de longo prazo são um produto dos EUA e do Canadá; escreva para [email protected] para perguntar sobre a Zâmbia, sem promessa.

Posso testar a integração antes de pagar por códigos reais?

Sim. Peça o modo sandbox para uma conta de desenvolvimento e obtenha números e códigos simulados para testes 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.