Testare la verifica telefonica in Burundi senza una SIM locale

Perché è così difficile controllare dall'estero un flusso di registrazione +257?

Immagina un team di prodotto che aggiunge il Burundi a un lancio nell'Africa orientale. La schermata di registrazione chiede un numero di telefono, il backend invia un codice monouso e nessuno nel team ha una SIM burundese. Le SIM roaming comprate durante un viaggio scadono, e chiedere a un collega di Bujumbura di leggere i codici a voce espone un numero personale e non può essere eseguito in una suite di test notturna.

L'instradamento OTP elimina questo collo di bottiglia. Al posto di un telefono fisico richiedi un numero di verifica del Burundi per un servizio specifico, il codice viene catturato da OTP Route e il tuo harness di test lo legge come qualsiasi altro evento. Lo stesso approccio vale per il personale operativo che gestisce profili aziendali su rotte burundesi e vuole tenere fuori i propri telefoni.

Quali servizi possono verificarsi con un numero del Burundi oggi?

L'istantanea live per il Burundi elenca app note di messaggistica, ricerca e commercio, tra cui WhatsApp, Viber, imo, Telegram, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, ChatGPT (OpenAI), Uber e Amazon. In totale la rotta copre più di 1.000 servizi.

L'inventario cambia durante la giornata, quindi considera quell'elenco un punto di partenza e non una promessa. Il tuo codice dovrebbe interrogare GET /api/v1/services e GET /api/v1/countries per il quadro aggiornato, e l'elenco completo si può sfogliare nella sezione paesi.

Come si inserisce l'API OTP del Burundi in un'esecuzione di test?

Crea una chiave nella console sviluppatori; le chiavi live iniziano con or_live_ e vanno in un header Bearer verso https://otproute.com/api/v1. Un tipico controllo automatizzato funziona così:

1. Chiama GET /api/v1/prices?country=bi&service=whatsapp per leggere il prezzo attuale di quella coppia.
2. Invia POST /api/v1/activations con il corpo {"service": "whatsapp", "country": "bi"}. La risposta contiene un id di attivazione e il numero +257 da digitare nell'app sotto test.
3. Attendi il webhook activation.sms_received, oppure fai polling su GET /api/v1/activations/{id} a intervalli ragionevoli.
4. Verifica il codice nel test e chiudi l'esecuzione.

Le richieste webhook includono X-OTPRoute-Signature: t=<unix>,v1=<hex>, un HMAC-SHA256 di <t>.<raw body> calcolato con il secret dell'endpoint. Ricalcolalo, confrontalo in tempo costante e scarta i timestamp vecchi; questa guida spiega i dettagli. Un account può avere fino a 10 chiavi e 5 endpoint webhook, con un limite di 300 richieste al minuto. Riferimento completo: documentazione.

Cosa deve aspettarsi il mio validatore da un numero burundese?

Il Burundi usa un piano di numerazione chiuso: i numeri degli abbonati hanno otto cifre dopo il prefisso internazionale e non c'è un prefisso di linea nazionale da eliminare. In E.164 significa +257 seguito da otto cifre, salvato senza spazi. I form spesso lo mostrano raggruppato a coppie, quindi normalizza l'input rimuovendo spazi, trattini e un eventuale 00 iniziale prima del salvataggio.

Un bug frequente è un validatore scritto per numeri nazionali di nove o dieci cifre che rifiuta in silenzio voci +257 valide. Aggiungi ai tuoi unit test un caso con questa lunghezza.

Il kirundi, il francese e l'inglese sono lingue ufficiali e lo swahili è molto usato nel commercio. I messaggi di verifica delle app globali di solito arrivano in inglese o in francese, a seconda della logica di localizzazione del mittente: analizza le cifre invece di cercare un testo preciso.

Il codice non è arrivato: e adesso?

Ogni attivazione resta aperta per 20 minuti. Se in quel tempo nessun SMS raggiunge il numero, oppure annulli con POST /api/v1/activations/{id}/cancel, l'intero importo torna automaticamente nel tuo wallet.

• Lascia scorrere la finestra prima di dichiarare il fallimento: alcuni mittenti mettono i messaggi in coda.
• Verifica che il servizio di destinazione accetti numeri virtuali, perché alcuni li rifiutano per policy.
• Riprova più tardi, oppure prova lo stesso flusso su un'altra rotta di servizio.
• Evita di rifare l'ordine in un ciclo serrato; lascia passare del tempo tra un tentativo e l'altro.

Preferisci la dashboard? Accedi, scegli Burundi e il servizio, copia il numero nell'app e guarda il codice comparire a schermo. Altre tattiche sono nella guida su come ridurre i fallimenti nella consegna degli OTP.

Possiamo tenere una linea burundese per account a cui accediamo più volte?

Non come prodotto self-service. OTP Route non vende numeri del Burundi a lungo termine; l'OTP Gateway assegna un numero per ogni verifica. Se il tuo team ha davvero bisogno di una linea persistente lì, scrivi a [email protected] descrivendo il caso d'uso; la disponibilità dipende dalle norme locali e non è assicurata.

I Numeri Virtuali Dedicati esistono solo negli Stati Uniti e in Canada, da $1.95/month, con SMS in entrata, inoltro via webhook e chiamate dal browser. Guarda i numeri virtuali se una linea statunitense o canadese va bene per i tuoi account di staging.

Come viene fatturato l'uso per il Burundi?

C'è un unico wallet prepagato in USD, senza canone mensile e senza piano da scegliere. La ricarica avviene con carta o con stablecoin USDT/USDC; l'amministrazione riceve per email una fattura PDF per ogni ricarica. Prima di collegare i pagamenti alla CI, chiedi di passare un account di sviluppo alla sandbox, che restituisce numeri e codici simulati senza toccare i fondi del wallet.

Usa ogni numero solo per il tuo prodotto o per account aziendali legittimi, rispetta i termini di ogni servizio e ricorda che si applica l'Acceptable Use Policy di OTP Route. Le tariffe attuali sono nella pagina dei prezzi.

Domande frequenti

Posso testare il flusso di registrazione della mia app per il Burundi senza una SIM locale?

Sì. Ordina un numero +257 dall'OTP Gateway per il tuo servizio, inseriscilo nell'app e leggi il codice dalla dashboard, dall'API o da un webhook.

Quale id paese usa l'API per il Burundi?

Passa bi come valore di country, per esempio in POST /api/v1/activations insieme a un id di servizio come telegram.

Mi viene addebitato qualcosa se il codice +257 non arriva?

No. Se nulla arriva entro la finestra di 20 minuti, oppure annulli, l'intero importo viene restituito automaticamente al tuo wallet.

I numeri burundesi hanno uno zero iniziale da eliminare?

No. Il Burundi non ha prefisso di linea, quindi la forma E.164 è semplicemente +257 più otto cifre.

In quale lingua sarà scritto un SMS di verifica del Burundi?

Dipende dal servizio mittente, ma di solito è inglese o francese. Estrai il codice numerico invece di fare affidamento sul testo del messaggio.

Posso riutilizzare lo stesso numero del Burundi il mese prossimo?

No. I numeri del Gateway servono per una sola verifica. Per accessi ripetuti è disponibile un Numero Dedicato, ma solo negli Stati Uniti e in Canada.

Quanto costa un numero di verifica del Burundi?

I prezzi per il Burundi partono da $0.20 per codice, con importo definito per ciascun servizio. La cifra esatta è restituita da GET /api/v1/prices e mostrata prima dell'ordine.

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.