Testare le registrazioni +243 nella RDC senza una SIM a Kinshasa

Il tuo team sta aggiungendo la RDC, ma nessuno ha una SIM +243. E adesso?

È una situazione comune per i team di prodotto e QA: la roadmap dice Repubblica Democratica del Congo, la release candidate è pronta e le persone che devono approvare il passaggio di verifica telefonica si trovano in un altro paese. Spedire SIM fisiche a un laboratorio di test, tenerle ricaricate e far girare i telefoni in ufficio è lento e lega ogni test a chi ha il telefono quel giorno.

L'OTP Gateway elimina questo collo di bottiglia. Chiedi un numero +243 per un servizio specifico, lo usi una sola volta sulla tua schermata di registrazione o di accesso e il codice arriva dove i tuoi strumenti possono leggerlo. Così un numero di verifica del Congo (RDC) diventa qualcosa che uno script di test può richiedere su richiesta, come qualsiasi altra fixture.

Motivi tipici per cui i team eseguono questo controllo:

• confermare che una schermata di onboarding in francese accetti e formatti correttamente i numeri congolesi;
• fare test di regressione su un'app mobile prima di un rilascio regionale in Africa centrale;
• permettere a un team operativo di verificare un account aziendale senza esporre il telefono personale di un dipendente.

Quali servizi può verificare un numero +243 in questo momento?

La copertura per la RDC comprende attualmente più di 1.000 servizi. Tra i più richiesti nello snapshot live ci sono WhatsApp, Telegram, Facebook, Instagram, TikTok, imo, Viber, Signal, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Amazon e ChatGPT (OpenAI).

Vale la pena segnalare le app di messaggistica come imo, Viber e WhatsApp, perché molti prodotti nella regione affidano loro assistenza e notifiche e il QA spesso ha bisogno di un account sulla stessa fascia di numeri degli utenti reali.

L'inventario cambia durante la giornata, quindi considera qualsiasi elenco un punto di partenza. La fonte autorevole è quella live: GET /api/v1/countries e GET /api/v1/prices restituiscono ciò che si può ordinare in questo momento, e la dashboard mostra gli stessi dati prima del pagamento. Il catalogo completo è sotto tutti i paesi.

Come si inserisce l'API OTP del Congo (RDC) in un'esecuzione di test?

Tutto avviene su https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_, creata nella Developer console. Un account può avere fino a 10 chiavi e 5 endpoint webhook, con un limite di 300 richieste al minuto.

1. Cerca i prezzi con GET /api/v1/prices?country=cd&service=whatsapp (sostituisci il servizio che stai testando). L'id paese della RDC è cd.
2. Effettua l'ordine con POST /api/v1/activations e un corpo JSON come {"service": "whatsapp", "country": "cd"}. Ottieni un id di attivazione e il numero +243.
3. Digita quel numero nel passaggio di verifica della tua app.
4. Attendi activation.sms_received sul tuo webhook, oppure interroga GET /api/v1/activations/{id} ogni pochi secondi.
5. Rilascia gli ordini inutilizzati con POST /api/v1/activations/{id}/cancel.

Le chiamate dei webhook includono X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 su "<t>.<raw body>" con il secret dell'endpoint, confronta in tempo costante e scarta i timestamp obsoleti. La guida alla cattura via webhook e il riferimento API trattano i dettagli di questa API di verifica SMS.

Come vanno memorizzati i numeri +243 e in che lingua sarà l'SMS?

I numeri congolesi si scrivono a livello locale con il prefisso interurbano 0 seguito da nove cifre. Nella forma internazionale lo zero scompare: +243 e poi quelle nove cifre. Salva la versione E.164, elimina spazi e zero iniziale in input e verifica che il tuo modulo accetti sia la grafia locale sia quella internazionale, perché gli utenti digitano quella che hanno visto per ultima.

Il francese è la lingua ufficiale, mentre lingala, swahili, kikongo e tshiluba sono le lingue nazionali. I messaggi di verifica dei servizi globali arrivano in genere in francese o in inglese, a seconda dell'app e delle impostazioni dell'account. Non fare il parsing sul testo circostante; estrai il gruppo di cifre dal corpo, così lo stesso parser funziona qualunque sia la lingua del template.

Per un passaggio di localizzazione conviene salvare il testo completo dell'SMS insieme al codice estratto. Così traduttori e QA hanno una traccia di ciò che un utente congolese legge davvero.

Cosa fare se il codice di verifica non compare?

Ogni ordine resta aperto per 20 minuti. Paghi solo se il codice arriva; se la finestra si chiude senza SMS, o annulli, l'intero importo torna automaticamente nel portafoglio. Quindi un numero silenzioso costa tempo, non denaro.

Quando succede:

• lascia scorrere la finestra prima di dichiarare il fallimento, perché alcuni servizi inviano in ritardo;
• riprova più tardi, oppure prova un'altra rotta di servizio, dato che la disponibilità cambia di ora in ora;
• verifica se il servizio accetta davvero numeri virtuali, perché alcuni li rifiutano;
• non riordinare in un ciclo serrato, che consuma il limite di richieste senza migliorare l'esito.

L'articolo su come ridurre i mancati recapiti OTP approfondisce la progettazione dei retry per il routing OTP.

Esiste una linea +243 a lungo termine per gli account che teniamo?

No. OTP Route non offre un numero a lungo termine in self-service nella RDC. I numeri del Gateway sono pensati per un solo codice ciascuno, il che va bene per i test di registrazione ma non per un account che deve accedere di nuovo tra sei mesi.

I numeri dedicati, che tieni finché si rinnovano, sono un prodotto per Stati Uniti e Canada da $1.95/month. Se il tuo team ha bisogno di una linea congolese duratura, scrivi a [email protected] descrivendo l'uso; la disponibilità dipende dalle norme locali e non può essere promessa.

Come viene gestita la fatturazione per il traffico di test sulla RDC?

C'è un unico portafoglio prepagato in USD, senza canone mensile e senza piani da scegliere. Ricarichi con carta o con USDT/USDC e ogni ricarica arriva con una fattura PDF via email, che rende facile riconciliare la spesa del QA. Consulta i prezzi per vedere come il prezzo live viene mostrato prima di ogni ordine.

Per il lavoro di integrazione, su richiesta un account di sviluppo può essere portato in sandbox; restituisce numeri e codici simulati così una pipeline può essere provata end to end senza spendere fondi del portafoglio.

Usa questi numeri solo sui tuoi prodotti e account, rispetta i termini di ciascun servizio e ricorda che la Acceptable Use Policy di OTP Route si applica a ogni ordine.

Domande frequenti

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

Sì. Ordina un numero +243 dall'OTP Gateway per il servizio che stai testando, inseriscilo nella tua app e leggi il codice nella dashboard o tramite API.

Quale id paese usa l'API per la Repubblica Democratica del Congo?

Usa cd sia nella query dei prezzi sia nel corpo dell'attivazione, ad esempio {"service": "telegram", "country": "cd"}.

Mi viene addebitato qualcosa se un codice +243 non arriva?

No. Un ordine +243 che resta silenzioso per 20 minuti, o che annulli prima, viene rimborsato per intero nel portafoglio senza aprire alcun ticket.

Devo salvare i numeri congolesi con lo zero iniziale?

Salvali in formato E.164, cioè +243 seguito da nove cifre con lo zero del prefisso interurbano rimosso. Tieni il formato locale solo per la visualizzazione, se i tuoi utenti se lo aspettano.

Il mio personale può usare lo stesso numero +243 per accedere di nuovo il mese prossimo?

Non in modo affidabile, perché i numeri del gateway servono per un solo codice. Le linee dedicate a lungo termine sono in self-service solo negli Stati Uniti e in Canada; per la RDC puoi scrivere a [email protected] per chiedere.

C'è un modo per eseguire la CI sull'API senza spendere denaro?

Sì. Chiedi di portare il tuo account di sviluppo in sandbox e restituirà numeri e codici simulati.

Perché un servizio ha rifiutato il numero +243 che ho ordinato?

Alcuni servizi rifiutano i numeri virtuali o limitano certe fasce. Annulla o lascia scadere la finestra per ottenere il rimborso, poi riprova più tardi o prova un'altra rotta di servizio.

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.