API di verifica SMS per la Nigeria (+234) per team QA, fintech e di lancio

Quali endpoint devo chiamare per ricevere un OTP nigeriano?

Tutto si trova sotto https://otproute.com/api/v1 e si autentica con una chiave Bearer che inizia con or_live_. L'id del paese per la Nigeria è ng. Un'integrazione tipica effettua quattro chiamate:

1. GET /api/v1/prices?country=ng&service=<id> per confermare il prezzo attuale prima di procedere.
2. POST /api/v1/activations con {"service": "<id>", "country": "ng"} per riservare un numero +234. Conserva l'id di attivazione restituito: ogni chiamata successiva e ogni evento webhook fanno riferimento a esso.
3. GET /api/v1/activations/{id} per leggere lo stato e, a consegna avvenuta, il codice.
4. POST /api/v1/activations/{id}/cancel se il test fallisce a monte e non ti serve più il numero.

GET /api/v1/balance è utile come controllo preliminare in CI, così una suite notturna fallisce subito se il wallet è scarico. La guida all'integrazione dell'API OTP illustra la stessa sequenza con la gestione degli errori.

Una suite di test a Lagos deve usare il polling o i webhook?

Il polling va bene per poche prove manuali. Quando una pipeline ordina più numeri +234 in parallelo, i webhook sono più puliti. Registra uno dei tuoi cinque endpoint nella console per sviluppatori e sottoscrivi activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta contiene X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 sul timestamp, un punto e il corpo grezzo usando il segreto dell'endpoint, confronta in tempo costante e scarta la richiesta se il timestamp è vecchio. Salva gli id di attivazione già elaborati, così un evento recapitato di nuovo non fa partire il test due volte. L'articolo su come proteggere i webhook OTP con HMAC contiene una checklist più completa. Mantieni il traffico totale sotto le 300 richieste al minuto per account: un limite ampio se ti affidi agli eventi invece che a un polling serrato.

Quali servizi sono disponibili sulle rotte +234?

La rotta ng elenca attualmente più di 2.700 servizi. Tra quelli richiesti più spesso ci sono WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon e ChatGPT (OpenAI). La disponibilità cambia nel corso della giornata man mano che i nostri partner carrier aggiornano l'offerta: interroga quindi la disponibilità in tempo reale invece di dare per scontato che un servizio visto ieri sia ancora presente.

Perché i team hanno bisogno di un numero di verifica nigeriano?

La Nigeria è uno dei mercati fintech e di app consumer più attivi dell'Africa, e molti prodotti usano il numero di telefono come identità principale. Per questo il passaggio via SMS è una parte critica dell'onboarding di wallet, app di prestito, ride-hailing, delivery e prodotti social. I team fuori dal paese usano un numero +234 per i test per verificare che il flusso di registrazione, il timer di reinvio e i testi di errore si comportino come per un utente locale.

L'inglese è la lingua ufficiale, quindi i messaggi di verifica di solito arrivano in inglese, il che rende semplice la logica delle asserzioni nei test automatici. I team fintech, in particolare, possono consultare la pagina sull'onboarding fintech per capire come tutto questo si affianca ai controlli di identità che OTP Route non sostituisce.

Come sono formattati i numeri di cellulare nigeriani?

Il prefisso internazionale è +234 e il prefisso nazionale (trunk) è 0. I nigeriani scrivono di solito un cellulare con undici cifre che iniziano con zero, ad esempio 0803 123 4567; in formato internazionale lo zero scompare e si ottiene +234 803 123 4567. Salva il valore in formato E.164 (+234803...), accetta in input il formato locale a undici cifre ed elimina lo 0 iniziale prima del salvataggio. Un validatore che controlla solo la lunghezza totale accetterà senza problemi +2340803..., una causa frequente di invii falliti in produzione.

Posso ordinare un numero nigeriano dalla dashboard?

Sì. Registrati con un codice via email o con Google, ricarica il wallet, apri l'OTP Gateway, scegli Nigeria e il servizio, quindi conferma il prezzo mostrato. Il numero è pronto subito e il codice compare accanto all'ordine appena arriva.

Se non arriva, lascia scorrere la finestra di 20 minuti: paghi solo se il codice arriva, e gli ordini scaduti o annullati vengono rimborsati automaticamente. Poi prova un nuovo ordine un po' più tardi, prova una rotta diversa come il Ghana se il test lo consente e verifica se il servizio rifiuta i numeri virtuali. Evita di lanciare nuovi ordini in un ciclo serrato.

E per le linee nigeriane a lungo termine, la fatturazione e la sandbox?

OTP Route non offre un numero nigeriano a lungo termine in self-service. I Dedicated Numbers sono venduti solo per Stati Uniti e Canada, da $1.95/mese. Per una linea +234 duratura scrivi a [email protected]: la possibilità di fornirla dipende dalla normativa locale.

La spesa passa da un unico wallet prepagato in USD, senza piani né canone mensile. Ricarichi con carta o con USDT/USDC e ricevi una fattura PDF per ogni ricarica. Chiedi al supporto di passare un account di sviluppo alla modalità sandbox e la tua integrazione riceverà numeri e codici simulati, così potrai testare l'intero percorso dei webhook senza spendere fondi del wallet.

Domande frequenti

Posso testare la registrazione nigeriana della mia app senza una SIM locale?

Sì. Ordina un numero +234 dall'OTP Gateway e leggi il codice nella dashboard o tramite l'API.

Qual è l'id del paese Nigeria nell'API di OTP Route?

Usa ng come valore di country nelle ricerche di prezzo e nelle richieste di attivazione.

Quanto costa ricevere un OTP SMS dalla Nigeria?

Da $0.20 per codice; l'importo esatto dipende dal servizio e viene restituito dall'endpoint dei prezzi.

Pago se non arriva alcun SMS?

No. Se non arriva nulla entro 20 minuti, o se annulli, l'intero importo torna nel wallet.

Come devo salvare un numero come 0803 123 4567?

Elimina lo zero iniziale e salvalo come +2348031234567, la forma E.164 senza spazi.

È lecito usare questi numeri per qualsiasi account?

Solo per i tuoi prodotti e account legittimi. Rispetta i termini di ogni servizio e l'Acceptable Use Policy di OTP Route; alcuni servizi rifiutano del tutto i numeri virtuali.

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.