Recebendo códigos SMS OTP do Nepal: preparação, etapas e correções para testes +977

Pré-voo: o que você precisa ter pronto antes de pedir um número do Nepal?

Uma rápida rodada de preparação evita muita depuração confusa depois. Antes do primeiro pedido, confira se você tem:

1. Credenciais. Gere uma chave or_live_ no console do desenvolvedor e envie-a como token Bearer. Chaves separadas para desenvolvimento local, CI e ferramentas de produção tornam a rotação indolor.
2. Os ids de país e de serviço. O Nepal é np; descubra o id do serviço com GET /api/v1/services.
3. Fundos ou sandbox. Consulte GET /api/v1/balance ou peça que a sua conta de desenvolvimento seja passada para sandbox, para que números e códigos simulados exercitem a integração de graça.
4. Uma escolha de entrega. Decida entre um endpoint de webhook e o polling antes de escrever o harness de testes, e não no meio do caminho.
5. Uma visualização de caixa de entrada com suporte a Unicode. Os códigos de modelos em nepalês chegam em devanágari, e os seus logs devem exibi-los corretamente.

Se você é novo no modelo, o que é um OTP gateway dá o contexto em poucos minutos.

Quais apps podem entregar códigos a uma linha +977?

Mais de 1.700 serviços podem ser roteados atualmente para o Nepal. Entre os populares estão Viber, WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, Signal, imo, Amazon e Claude.

Essa lista é um instantâneo, não uma promessa. A disponibilidade muda durante o dia, e é por isso que GET /api/v1/prices?country=np&service=<id> devolve o preço e a disponibilidade ao vivo para o par exato de que o seu teste precisa.

Passo a passo: receber um SMS OTP do Nepal pela API

Com a lista de preparação concluída, o fluxo da API de OTP do Nepal exige no máximo cinco chamadas:

1. Confirme o preço atual para np e o seu serviço.
2. Crie a ativação com POST /api/v1/activations e o corpo {"service": "<id>", "country": "np"}. Guarde o id da ativação devolvido; ele é a chave de tudo o que vem depois.
3. Informe o número +977 no fluxo em teste e dispare o SMS.
4. Colete o código por um webhook activation.sms_received ou consulte GET /api/v1/activations/{id} com um intervalo razoável entre as chamadas.
5. Cancele com POST /api/v1/activations/{id}/cancel se o teste for interrompido antes.

No lado do webhook, verifique X-OTPRoute-Signature antes de confiar em uma requisição: monte <t>.<raw body>, assine com HMAC-SHA256 usando o segredo do endpoint, compare com v1 e rejeite timestamps antigos. Depois faça um upsert pelo id da ativação para que um evento reenviado não cause dano. A captura de OTP por webhook mostra o padrão completo.

Prefere clicar a programar? No painel da OTP Route, escolha o Nepal, escolha o serviço, aceite o preço exibido e o número aparece com um cronômetro; o código surge nessa mesma tela.

Verificações de formato para números móveis nepaleses

Os celulares nepaleses têm dez dígitos e começam com 9, geralmente 98 ou 97. Dentro do país, os números fixos são discados com um 0 de tronco mais um código de área, mas esse 0 nunca pertence ao formato internacional. Um registro de teste deve, portanto, ficar assim: +97798xxxxxxxx.

Coisas que valem a pena afirmar nos seus testes de validação:

• Um usuário que digita o número com um 0 inicial acaba com o 0 removido depois do +977.
• Um celular de dez dígitos sem nenhum prefixo é aceito e normalizado para E.164.
• Espaços e hifens que os usuários colam de cartões de contato são limpos antes do armazenamento.

O conteúdo do SMS também merece uma verificação. O nepalês é escrito em devanágari, e uma mensagem em devanágari é enviada como Unicode, o que permite muito menos caracteres por segmento do que o texto em alfabeto latino. Se o seu modelo de verificação for localizado, confirme que o código ainda chega em um único segmento e não é empurrado para uma divisão pelas palavras ao redor. Muitos serviços simplesmente enviam modelos em inglês, então teste as duas situações.

Por que as equipes constroem e testam para o mercado nepalês

O Nepal importa para mais produtos do que o seu tamanho sugere. Grande parte dos trabalhadores nepaleses vive no exterior, então produtos de remessas, carteiras digitais e mensagens que atendem os corredores do Golfo, da Malásia e outros muitas vezes precisam verificar usuários que ainda têm um número +977. Aplicativos de mensagens como Viber e WhatsApp fazem parte da comunicação cotidiana por lá.

As equipes pedem um número +977 para testes quando:

• Lançam um fluxo de cadastro para usuários nepaleses e precisam provar que o país aparece no seletor com a máscara certa.
• Verificam textos em nepalês nas telas de onboarding e de recuperação.
• Reproduzem o relato de um cliente da diáspora de que o código de login nunca chegou.

A página de verificação em apps móveis mostra como as equipes de apps estruturam esse tipo de cobertura por país.

Solução de problemas: o código não chegou

Os códigos ausentes têm um punhado de causas habituais, e a solução raramente é pedir de novo imediatamente.

• Paciência primeiro. Dê à ativação os 20 minutos completos; mensagens em fila ainda chegam com atraso.
• Políticas sobre números virtuais. Alguns serviços recusam números virtuais. Quando isso acontece, a ativação simplesmente expira e o reembolso cai na carteira.
• Escolha da rota. Tente mais tarde, ou use uma rota diferente para o mesmo serviço, em vez de insistir em uma só.
• Disciplina de taxa. Refazer pedidos em um laço curto consome o limite de 300 requisições por minuto e raramente ajuda.
• O seu próprio app. Confirme que a solicitação do SMS realmente foi disparada; verifique a requisição de saída nos seus logs.

Um evento activation.expired é o sinal limpo de que nada chegou e nada foi cobrado.

Linhas de longo prazo e pagamento das rotas do Nepal

A OTP Route não oferece um número de longo prazo do Nepal em autoatendimento. Os Dedicated Numbers existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês. Se a sua equipe precisa de uma linha +977 persistente, escreva para [email protected]; o que pode ser providenciado depende das regras locais, e nada é garantido.

O pagamento é pay as you go a partir de uma única carteira pré-paga em USD, recarregada por cartão ou com USDT ou USDC, com uma fatura em PDF enviada por e-mail a cada recarga e sem mensalidade. Veja os preços para saber como as cobranças são exibidas e cadastre-se para criar uma conta com um código por e-mail ou com o Google.

Perguntas frequentes

Posso receber um OTP nepalês sem um chip do Nepal?

Sim. O OTP Gateway emite um número +977 para uma única verificação, e você lê o código no painel ou pela API.

Que código de país a API espera para o Nepal?

Envie np como país nas requisições de preço e de ativação.

Devo manter o 0 inicial ao armazenar um número do Nepal?

Não. Elimine o 0 de tronco e armazene o número em E.164 depois de +977.

Os códigos em nepalês serão exibidos corretamente no painel?

A mensagem é exibida como foi recebida; garanta que seus próprios logs e asserções de teste lidem com texto em devanágari para que o código possa ser extraído de forma confiável.

O que acontece com o meu dinheiro se um código do Nepal nunca vier?

Nada é cobrado: uma ativação que não vê nenhum SMS nos seus 20 minutos, ou uma que você cancela, é reembolsada integralmente na carteira, sem que você precise pedir.

Posso usar o mesmo número +977 para um login posterior?

Não, cada número do OTP Gateway cobre um código. Para contas que precisam entrar de novo mais tarde, o adequado é um Dedicated Number, mas eles são oferecidos apenas nos EUA e no Canadá.

Existem regras de uso para os números de verificação do Nepal?

Sim. Respeite os termos de cada serviço e a Política de Uso Aceitável, e use os números apenas para testar ou operar seus próprios produtos e contas legítimos.

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.