Testare i flussi di registrazione +236 quando nessuno nel team ha una SIM centrafricana

Perché un passaggio di verifica +236 è così difficile da riprodurre dall'estero?

La situazione tipica è questa: un prodotto viene lanciato nell'Africa centrale francofona, qualcuno segnala un bug perché il codice monouso non è arrivato a un utente di Bangui, e l'ingegnere incaricato non ha modo di inserire un numero centrafricano nel modulo. Le SIM in roaming sono lente da ottenere, i colleghi sul posto sono impegnati in lavori veri e gli emulatori non possono produrre un vero SMS di un operatore.

Un servizio di instradamento OTP come OTP Route colma questo divario, e la sua API OTP per la Repubblica Centrafricana è la stessa usata per ogni altro paese. Invece di spedire hardware in giro, chiedi una linea +236 con una chiamata API, la digiti nella tua schermata di registrazione e rileggi il codice in modo programmatico. La stessa richiesta funziona in una sessione sul portatile, in un job di regressione notturno o nella scheda del browser di un tecnico dell'assistenza, e questo fa comportare un mercato difficile da raggiungere come qualsiasi altra riga della tua matrice di test.

Quali servizi possono ricevere oggi i codici SMS della Repubblica Centrafricana?

L'istantanea live per cf elenca più di 900 servizi. Tra le rotte più diffuse ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) e Uber.

La disponibilità cambia durante la giornata mentre i nostri partner carrier ruotano l'inventario, quindi considera ogni elenco su una pagina web un punto di partenza e non una promessa. Prima di ogni esecuzione, chiedi a GET /api/v1/prices?country=cf&service=<id> il prezzo corrente e se la rotta è aperta. Alcune app del catalogo rifiutano del tutto le linee virtuali; è una decisione dell'app, non della rete, ed è proprio per questo che gli ordini senza risposta vengono rimborsati.

Come richiede un backend un numero +236 per i test?

Tutto sta sotto https://otproute.com/api/v1 e si autentica con una chiave Bearer con prefisso or_live_, emessa nella console sviluppatori. Una sessione minima dell'API di verifica SMS funziona così:

1. Cerca gli identificatori una volta con GET /api/v1/services e GET /api/v1/countries; la Repubblica Centrafricana è cf.
2. Conferma prezzo e disponibilità con GET /api/v1/prices.
3. Crea l'ordine con POST /api/v1/activations e un corpo come {"service": "viber", "country": "cf"}.
4. Invia il numero +236 restituito alla schermata sotto test.
5. Ricevi il codice tramite il webhook activation.sms_received, oppure fai polling su GET /api/v1/activations/{id} ogni pochi secondi.
6. Se il test si interrompe, rilascia la linea con POST /api/v1/activations/{id}/cancel.

Le chiamate webhook portano X-OTPRoute-Signature: t=<unix>,v1=<hex>. Il tuo ricevitore dovrebbe ricostruire l'HMAC-SHA256 di <t>.<raw body> con il secret di quell'endpoint, confrontarlo con v1 in tempo costante e scartare ogni consegna con un timestamp vecchio. La guida alla cattura via webhook mostra un handler completo, e il riferimento è nella documentazione API.

Cosa bisogna sapere sui numeri centrafricani e sulla lingua dei messaggi?

I numeri della Repubblica Centrafricana seguono un piano chiuso di otto cifre senza prefisso di linea, quindi la forma nazionale e quella internazionale differiscono solo per il prefisso paese. Salva ogni valore in E.164, per esempio +236 seguito dalle otto cifre locali, ed elimina spazi o trattini in input. Una validazione che pretende uno zero iniziale, o dieci cifre, rifiuterà in silenzio utenti reali.

Il francese e il sango sono le lingue ufficiali. La maggior parte delle app internazionali invia il testo di verifica in francese o in inglese a seconda della lingua dell'account, quindi fai cercare al tuo parser le cifre e non una frase specifica. I team testano qui di solito quando estendono un lancio nell'Africa occidentale o centrale, usano strumenti per ONG e operazioni sul campo, oppure assistono clienti con familiari nella regione.

Chi non è sviluppatore può ottenere un numero di verifica della Repubblica Centrafricana?

Sì. Product manager, responsabili dell'assistenza e personale delle agenzie possono fare tutto dal browser:

• Crea un account con un codice via email o con l'accesso Google e attiva l'autenticazione a due fattori TOTP.
• Apri l'OTP Gateway, scegli il servizio e seleziona Repubblica Centrafricana.
• Controlla il prezzo live mostrato prima di ordinare, poi conferma.
• Incolla il numero +236 nell'app e attendi che il codice compaia a schermo.

L'attivazione resta aperta per 20 minuti. Paghi solo se arriva un codice; se annulli o lasci chiudere la finestra, l'intero importo torna nel wallet.

E se il codice non compare mai sulla linea +236?

Un numero muto di solito significa che l'app ha limitato la richiesta, ha rifiutato una linea virtuale o che la rotta era occupata. Procedi con calma:

• Lascia che la finestra faccia tutto il suo corso prima di dichiarare il fallimento; alcuni mittenti mettono i messaggi in coda.
• Annulla e riprova più tardi, oppure passa a un'altra rotta per lo stesso servizio, se disponibile.
• Verifica se il servizio è noto per rifiutare i numeri virtuali; in tal caso nessun nuovo tentativo servirà.
• Evita di rifare l'ordine in un ciclo serrato. I tentativi ripetuti possono far scattare limiti di frequenza sia lato app sia lato nostro (300 richieste al minuto per account).

Altri schemi sono nella guida su come ridurre i fallimenti nella consegna degli OTP.

Esiste una linea +236 a lungo termine e come viene fatturato l'uso?

No. I Numeri Dedicati in self-service esistono solo negli Stati Uniti e in Canada, da $1.95/month, quindi non c'è nessuna linea centrafricana permanente da acquistare nella dashboard. Se un progetto ne ha davvero bisogno, scrivi a [email protected]; la fattibilità dipende dalle norme locali e non possiamo prometterla.

La fatturazione dell'OTP Gateway passa da un unico wallet prepagato in USD, senza canone mensile. La ricarica avviene con carta o con stablecoin USDT/USDC, e a ogni ricarica viene inviata via email una fattura PDF. Gli sviluppatori che vogliono provare un'integrazione senza spendere possono chiedere la modalità sandbox, che restituisce numeri e codici simulati. Le tariffe complete sono nella pagina dei prezzi. Rispetta i termini di ogni app; l'Acceptable Use Policy di OTP Route copre ogni ordine.

Domande frequenti

Come ricevo i codici SMS OTP della Repubblica Centrafricana senza una SIM locale?

Ordina un numero +236 dall'OTP Gateway, inseriscilo nella tua app e leggi il codice dalla dashboard, da un webhook o dall'endpoint delle attivazioni.

Qual è l'id paese della Repubblica Centrafricana nell'API?

È cf. Usalo nella query dei prezzi e nel corpo dell'attivazione.

Quanto costa un numero +236 per i test?

I codici partono da $0.20 ciascuno e la cifra esatta dipende dal servizio. Il valore corrente per una rotta +236 è visibile nella dashboard e nell'endpoint dei prezzi prima di ordinare.

Un ordine +236 viene addebitato se il testo di verifica non arriva?

No. Se nessun messaggio arriva durante la finestra di 20 minuti, oppure annulli prima, l'intero importo viene riaccreditato automaticamente nel tuo wallet.

Devo salvare i numeri centrafricani con lo zero iniziale?

No. Il piano non ha prefisso di linea, quindi mantieni la forma E.164 con +236 e le otto cifre locali.

Posso tenere lo stesso numero +236 per accessi futuri?

Non in self-service. Ogni numero dell'OTP Gateway copre un solo codice e le linee a lungo termine sono un prodotto per Stati Uniti e Canada; puoi scrivere all'assistenza per chiedere altre opzioni.

C'è un modo per testare l'integrazione senza pagare?

Sì. Su richiesta un account di sviluppo può passare alla sandbox, che simula numeri e codici end to end.

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.