Testare le registrazioni +226: checklist per un numero di verifica del Burkina Faso

Cosa deve essere pronto prima di richiedere un numero +226?

La maggior parte dei primi tentativi falliti dipende da un pezzo di configurazione mancante, non dalla rotta in sé. Controlla questi punti prima del primo ordine:

• Una chiave API. Creala nella console sviluppatori; le chiavi live hanno il prefisso or_live_ e si inviano come token Bearer. Puoi avere fino a 10 chiavi, quindi dedica una chiave a staging e una alla CI.
• Un wallet con credito. Ricarica con carta o con USDT/USDC. Per un codice che non arriva non viene addebitato nulla.
• Gli id corretti. Il Burkina Faso è bf nell'API. Cerca l'id del servizio con GET /api/v1/services invece di indovinarlo.
• Un piano di consegna. Un endpoint webhook con il suo secret conservato in modo sicuro, oppure un ciclo di polling con intervalli ragionevoli. Un account può registrare fino a 5 endpoint webhook, utili per separare staging e produzione.
• Un account legittimo da verificare. Un utente di test sul tuo prodotto, oppure un account aziendale gestito dal tuo team. Valgono i termini di ciascun servizio e l'Acceptable Use Policy di OTP Route.

Il riferimento API elenca ogni campo, se vuoi leggerlo prima di scrivere codice.

Quali app possono recapitare codici su una rotta del Burkina Faso?

Il catalogo live per bf elenca attualmente più di 900 servizi. Tra i più diffusi disponibili al momento della stesura ci sono WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, imo, Viber, Signal, LinkedIn, Uber, Amazon e ChatGPT (OpenAI).

La disponibilità cambia durante la giornata, perché i nostri partner carrier aggiungono e liberano capacità: considera quell'elenco un'istantanea. Il tuo codice dovrebbe interrogare GET /api/v1/prices subito prima di ogni ordine; la risposta indica il prezzo corrente e se la coppia è ordinabile.

Come si svolge la sequenza API per il paese `bf`?

1. Leggi il prezzo della tua coppia con GET /api/v1/prices?country=bf&service=whatsapp (sostituisci l'id del tuo servizio).
2. Crea l'attivazione con POST /api/v1/activations e il corpo {"service": "whatsapp", "country": "bf"}. Salva l'id di attivazione restituito: tutto il resto fa riferimento a lui.
3. Fai partire l'SMS dall'app che stai testando, usando il numero +226 della risposta.
4. Attendi activation.sms_received sul tuo webhook. Controlla l'header X-OTPRoute-Signature, che ha la forma t=<unix>,v1=<hex>: calcola l'HMAC-SHA256 di "<t>.<raw body>" con il secret dell'endpoint, confronta e scarta le richieste con timestamp troppo vecchio. La guida come proteggere i webhook OTP con HMAC copre i casi limite.
5. Niente webhook? Fai invece polling su GET /api/v1/activations/{id} ogni pochi secondi.
6. Hai finito prima o stai testando un percorso di errore? Chiama POST /api/v1/activations/{id}/cancel. Vedrai anche activation.expired o activation.cancelled quando un'esecuzione termina senza codice.

L'account consente 300 richieste al minuto, più che sufficienti per il polling purché ogni esecuzione rallenti un po' tra una richiesta e l'altra.

Chi non scrive codice può ordinare un codice +226?

Sì. Assistenza clienti, marketing e account manager possono fare la stessa cosa a mano. Accedi, apri l'OTP Gateway, scegli Burkina Faso, seleziona il servizio e conferma il prezzo mostrato a schermo. Il numero compare subito; incollalo nell'app, richiedi l'SMS e il codice arriva nella stessa riga della dashboard. Puoi lasciare la scheda aperta o tornare più tardi: l'attivazione resta in ascolto per tutti i suoi 20 minuti.

Come conservare i numeri +226 e in quale lingua arriverà l'SMS?

Il Burkina Faso usa numeri nazionali di otto cifre e nessun prefisso di linea (trunk prefix), quindi non c'è uno zero iniziale da eliminare: la forma nazionale coincide con le cifre dopo +226. Salva i numeri in E.164 come +226 seguito da quelle otto cifre e normalizza l'input rimuovendo spazi, trattini e un eventuale 00 internazionale prima del salvataggio. Le regole di validazione copiate da mercati con lo zero iniziale rifiutano numeri +226 validi: è un classico bug di localizzazione che merita un test di regressione.

Il francese è da tempo la lingua dell'amministrazione, della scuola e degli affari, e il mooré, il dioula e il fulfulde sono molto parlati. La maggior parte dei modelli di verifica arriva in francese o in inglese a seconda della lingua dell'account, quindi assicurati che il tuo parser gestisca i caratteri accentati attorno alle cifre.

I team di solito testano qui quando si lanciano nell'Africa occidentale francofona, controllano i testi in francese di una schermata di registrazione o fanno l'onboarding di clienti per prodotti di pagamento e mobile money; la pagina onboarding fintech descrive questo schema.

Cosa provare se non arriva nessun codice sul numero?

• Lascia finire la finestra. Alcuni servizi inviano in ritardo; annullare al terzo minuto butta via un'esecuzione che potrebbe ancora riuscire.
• Verifica che il servizio accetti numeri virtuali. Alcune piattaforme li rifiutano del tutto. È esattamente il motivo per cui le attivazioni non usate vengono rimborsate.
• Prova un'altra rotta o riprova più tardi. Un momento diverso, o una rotta vicina dell'Africa occidentale, spesso si comporta in modo diverso.
• Non rifare l'ordine in un ciclo serrato. Le ripetizioni rapide tendono a far scattare i limiti di frequenza dell'app che invia il codice e peggiorano il tentativo successivo.

La guida su come ridurre i fallimenti nella consegna degli OTP approfondisce la progettazione dei retry.

Esiste un numero del Burkina Faso a lungo termine e come funziona la fatturazione?

Non esiste una linea +226 a lungo termine in self-service. I Numeri Dedicati sono un prodotto solo per Stati Uniti e Canada, da $1.95/month, con SMS in entrata e in uscita e chiamate dal browser. Se ti serve una linea permanente in Burkina Faso, scrivi a [email protected]; la fattibilità dipende dalle norme locali e non è garantita.

Le attivazioni +226 si pagano da un unico wallet prepagato in USD, senza abbonamento e senza livelli da scegliere. Ogni ricarica con carta o USDT/USDC riceve una fattura PDF via email. Per il lavoro di integrazione, chiedi di passare un account di sviluppo alla sandbox, che restituisce numeri e codici simulati così la tua suite di test non tocca mai fondi reali. Le tariffe aggiornate sono nella pagina dei prezzi.

Domande frequenti

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

Sì. Ordina un numero +226 sull'OTP Gateway, fai partire l'SMS dalla tua app e leggi il codice nella dashboard o tramite l'API. Paghi solo se il codice arriva.

Qual è l'id del Burkina Faso nell'API di OTP Route?

È bf. Abbinalo a un id di servizio ottenuto da GET /api/v1/services quando chiami gli endpoint dei prezzi o delle attivazioni.

I numeri +226 iniziano con uno zero?

No. Il Burkina Faso non ha prefisso di linea, quindi un numero è semplicemente +226 più otto cifre in formato E.164.

Per quanto tempo resta attivo un numero di verifica del Burkina Faso?

Venti minuti per attivazione. Se la finestra si chiude senza SMS, o se annulli, l'intero importo torna automaticamente nel tuo wallet.

Il codice arriverà in francese?

Dipende dal servizio mittente e dalla lingua impostata sull'account. Francese e inglese sono i casi più comuni, quindi testa entrambi se il tuo prodotto li supporta.

Posso usare un numero +226 per aprire molti account su una stessa piattaforma?

No. OTP Route serve per testare il tuo prodotto e gestire account aziendali legittimi. Registrazioni di massa o identità inventate violano l'Acceptable Use Policy e i termini della piattaforma.

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.