Ricevere codici SMS OTP del Nepal: preparazione, passi e rimedi per i test +977

Pre-flight: cosa serve avere pronto prima di richiedere un numero del Nepal?

Una breve fase di preparazione fa risparmiare molto debug confuso. Prima del primo ordine assicurati di avere:

1. Credenziali. Genera una chiave or_live_ nella console Developer e inviala come token Bearer. Chiavi separate per sviluppo locale, CI e strumenti di produzione rendono indolore la rotazione.
2. Gli id di paese e servizio. Il Nepal è np; trova l'id del servizio con GET /api/v1/services.
3. Fondi o sandbox. Controlla GET /api/v1/balance, oppure chiedi di portare il tuo account di sviluppo in sandbox, così numeri e codici simulati mettono alla prova l'integrazione gratis.
4. Una scelta di consegna. Decidi tra endpoint webhook e polling prima di scrivere l'harness di test, non a metà strada.
5. Una vista della inbox compatibile con Unicode. I codici dei template in nepalese arrivano in devanagari e i tuoi log devono mostrarli correttamente.

Se il modello ti è nuovo, che cos'è un OTP gateway offre il contesto in pochi minuti.

Quali app possono consegnare codici a una linea +977?

Più di 1.700 servizi sono attualmente instradabili verso il Nepal. Tra i più diffusi ci sono Viber, WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, Signal, imo, Amazon e Claude.

Quell'elenco è uno snapshot, non una promessa. La disponibilità cambia durante la giornata, ed è per questo che GET /api/v1/prices?country=np&service=<id> restituisce prezzo e disponibilità live per la coppia esatta di cui ha bisogno il tuo test.

Passo dopo passo: ricevere un SMS OTP del Nepal tramite l'API

Completata la lista di preparazione, il flusso dell'API OTP del Nepal richiede al massimo cinque chiamate:

1. Conferma il prezzo live per np e il tuo servizio.
2. Crea l'attivazione con POST /api/v1/activations e il corpo {"service": "<id>", "country": "np"}. Conserva l'id dell'attivazione restituito; è la chiave di tutto ciò che segue.
3. Inserisci il numero +977 nel flusso sotto test e fai partire l'SMS.
4. Raccogli il codice da un webhook activation.sms_received, oppure interroga GET /api/v1/activations/{id} con un ritardo ragionevole tra le chiamate.
5. Annulla con POST /api/v1/activations/{id}/cancel se il test si interrompe prima.

Lato webhook, verifica X-OTPRoute-Signature prima di fidarti di una richiesta: costruisci <t>.<raw body>, firmalo con HMAC-SHA256 usando il secret dell'endpoint, confrontalo con v1 e rifiuta i timestamp scaduti. Poi fai un upsert per id di attivazione, così un evento riconsegnato non fa danni. La cattura OTP via webhook mostra lo schema completo.

Preferisci cliccare invece di programmare? Nella dashboard di OTP Route scegli Nepal, scegli il servizio, accetta il prezzo mostrato e il numero appare con un timer; il codice compare in quella stessa schermata.

Controlli di formato per i numeri mobili nepalesi

I cellulari nepalesi hanno dieci cifre e iniziano con 9, di solito 98 o 97. All'interno del paese i numeri fissi si compongono con uno 0 di linea più un prefisso di zona, ma quello 0 non fa mai parte del formato internazionale. Un record di test dovrebbe quindi apparire come +97798xxxxxxxx.

Cose utili da verificare con asserzioni nei tuoi test di validazione:

• Un utente che digita il numero con uno 0 iniziale ottiene lo 0 rimosso dopo +977.
• Un cellulare di dieci cifre senza alcun prefisso viene accettato e normalizzato in E.164.
• Spazi e trattini incollati dalle schede contatto vengono puliti prima del salvataggio.

Anche il contenuto dell'SMS merita un controllo. Il nepalese si scrive in devanagari, e un messaggio in devanagari viene inviato come Unicode, il che permette molti meno caratteri per segmento rispetto al testo latino semplice. Se il tuo template di verifica è localizzato, conferma che il codice rientri ancora in un solo segmento e non venga spinto oltre la divisione dalle parole circostanti. Molti servizi inviano semplicemente template in inglese, quindi testa entrambi.

Perché i team sviluppano e testano per il mercato nepalese

Il Nepal conta per più prodotti di quanto suggerisca la sua dimensione. Una quota elevata di lavoratori nepalesi vive all'estero, quindi prodotti di rimesse, wallet e messaggistica che servono il Golfo, la Malesia e altri corridoi devono spesso verificare utenti che hanno ancora un numero +977. App di messaggistica come Viber e WhatsApp fanno parte della comunicazione quotidiana.

I team ordinano un numero +977 per i test quando:

• Lanciano un flusso di registrazione per utenti nepalesi e devono dimostrare che il paese compare nel selettore con la maschera giusta.
• Controllano le stringhe in nepalese nelle schermate di onboarding e di recupero.
• Riproducono la segnalazione di un cliente della diaspora secondo cui il codice di accesso non è mai arrivato.

La pagina sulla verifica per app mobili mostra come i team delle app strutturano questo tipo di copertura per paese.

Risoluzione dei problemi: il codice non è arrivato

I codici mancanti hanno una manciata di cause abituali, e il rimedio raramente è ordinare di nuovo subito.

• Prima la pazienza. Lascia all'attivazione tutti i suoi 20 minuti; i messaggi in coda arrivano comunque in ritardo.
• Politiche sui numeri virtuali. Alcuni servizi rifiutano i numeri virtuali. In quel caso l'attivazione scade semplicemente e il rimborso arriva sul wallet.
• Scelta della rotta. Riprova più tardi, oppure usa una rotta diversa per lo stesso servizio invece di insistere su una sola.
• Disciplina sulla frequenza. Riordinare in un ciclo serrato consuma il limite di 300 richieste al minuto e raramente aiuta.
• La tua app. Conferma che la richiesta dell'SMS sia davvero partita; controlla la richiesta in uscita nei tuoi log.

Un evento activation.expired è il segnale pulito che non è arrivato nulla e non è stato addebitato nulla.

Linee a lungo termine e pagamento delle rotte del Nepal

OTP Route non offre un numero del Nepal a lungo termine in self-service. I Dedicated Numbers esistono solo negli Stati Uniti e in Canada, da $1.95/month. Se il tuo team ha bisogno di una linea +977 persistente, scrivi a [email protected]; la possibilità di organizzare qualcosa dipende dalle norme locali e nulla è assicurato.

Il pagamento è pay as you go da un unico wallet prepagato in USD, ricaricato con carta o con USDT o USDC, con una fattura PDF inviata via email per ogni ricarica e nessun canone mensile. Consulta i prezzi per vedere come vengono mostrati gli addebiti e registrati per creare un account con un codice email o con Google.

Domande frequenti

Posso ricevere un OTP del Nepal senza una SIM nepalese?

Sì. L'OTP Gateway assegna un numero +977 per una singola verifica e leggi il codice nella dashboard o tramite API.

Quale codice paese si aspetta l'API per il Nepal?

Invia np come country nelle richieste di prezzo e di attivazione.

Devo mantenere lo 0 iniziale quando salvo un numero nepalese?

No. Elimina lo 0 di linea e salva il numero in E.164 dopo +977.

I codici in nepalese vengono mostrati correttamente nella dashboard?

Il messaggio viene mostrato così come ricevuto; assicurati che i tuoi log e le asserzioni di test gestiscano il testo in devanagari, in modo che il codice possa essere estratto in modo affidabile.

Che fine fanno i miei soldi se un codice del Nepal non arriva mai?

Non viene addebitato nulla: un'attivazione che non vede alcun SMS entro i suoi 20 minuti, o che annulli, viene rimborsata per intero sul wallet senza alcuna richiesta da parte tua.

Posso usare lo stesso numero +977 per un accesso successivo?

No, ogni numero dell'OTP Gateway copre un solo codice. Per gli account che devono accedere di nuovo più avanti la soluzione è un Dedicated Number, ma sono offerti solo negli Stati Uniti e in Canada.

Ci sono regole d'uso per i numeri di verifica del Nepal?

Sì. Rispetta i termini di ciascun servizio e l'Acceptable Use Policy e usa i numeri solo per testare o gestire i tuoi prodotti e account legittimi.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.