Testare i flussi di verifica +27: una checklist per i lanci in Sudafrica

Prima del primo ordine +27: una breve lista di preparazione

Spunta questi punti e la tua prima attivazione sudafricana dovrebbe andare a buon fine senza sorprese:

1. Wallet ricaricato. Un unico wallet prepagato in USD finanzia tutto; lo carichi con carta o con USDT/USDC. Nessun abbonamento.
2. Chiave emessa. Genera una chiave Bearer nella Developer console (inizia con or_live_). Tieni chiavi separate per CI e per staging, fino a 10 in totale.
3. Webhook registrato. Aggiungi un endpoint HTTPS e conserva il suo secret di firma. Puoi registrarne fino a cinque.
4. Normalizzatore dei numeri testato. Dagli un input del tipo 082 123 4567 e verifica che produca +2782... con lo 0 iniziale rimosso.
5. Id del servizio confermato. Prendi il catalogo da GET /api/v1/services invece di indovinare gli id.
6. Sandbox opzionale. Il supporto può mettere un account di sviluppo in sandbox, così numeri e codici simulati attraversano il tuo codice prima di qualsiasi spesa reale.

La guida ai test in CI mostra come collegare questi elementi in una pipeline.

Come vanno archiviati e normalizzati i numeri sudafricani?

Il Sudafrica usa il prefisso di rete 0. Un cellulare scritto in forma locale ha dieci cifre, per esempio 082 123 4567, e nella forma nazionale gli intervalli mobili iniziano di norma con 06, 07 o 08. Nel formato internazionale lo 0 scompare: la stessa linea diventa +27 82 123 4567, oppure +27821234567 una volta tolti gli spazi, cioè nove cifre dopo il prefisso internazionale.

Il classico bug è un valore salvato come +270821234567, prodotto quando un modulo incolla il prefisso internazionale al numero locale senza eliminare lo 0. Normalizza in ingresso, salva solo l'E.164 e mostra il formato locale con gli spazi esclusivamente per la visualizzazione. Se invii SMS in uscita da solo, la stessa regola mantiene coerenti i report di consegna e le ricerche utente.

Quali servizi possono inviare codici a un numero di verifica sudafricano?

Tra le rotte più richieste per za in questo momento ci sono WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) e Discord. Su tutto il catalogo il paese supporta più di 1.700 servizi e, poiché l'inventario si muove durante la giornata, l'API è il posto dove leggere la disponibilità attuale.

Perché i team scelgono questo mercato? Johannesburg e Città del Capo sono poli consolidati della tecnologia e della finanza, e molte aziende usano il Sudafrica come base per un rilascio più ampio nell'Africa meridionale. Il paese ha diverse lingue ufficiali, tra cui inglese, isiZulu, isiXhosa e afrikaans, ma la maggior parte dei messaggi di verifica arriva in inglese, quindi il QA di localizzazione tende a concentrarsi sulle schermate circostanti più che sul testo dell'SMS.

Passaggi: chiamare l'OTP API del Sudafrica dal tuo harness di test

Le richieste vanno a https://otproute.com/api/v1 con la tua chiave Bearer, fino a 300 al minuto.

1. GET /api/v1/prices?country=za&service=<id> restituisce il prezzo in tempo reale per la combinazione che vuoi.
2. POST /api/v1/activations con {"service": "<id>", "country": "za"} riserva un numero +27 e restituisce un id di attivazione.
3. Il tuo test inserisce il numero nell'app e fa partire l'SMS.
4. L'evento activation.sms_received raggiunge il tuo webhook. Prima di fidartene, ricostruisci l'HMAC-SHA256 di <t>.<raw body> con il secret dell'endpoint, confrontalo con v1 in X-OTPRoute-Signature e scarta le richieste con timestamp troppo vecchio.
5. Preferisci il polling? Leggi GET /api/v1/activations/{id} a intervalli moderati.
6. Le esecuzioni abbandonate dovrebbero chiamare POST /api/v1/activations/{id}/cancel, e GET /api/v1/balance permette a un job di fermarsi in anticipo quando i fondi scarseggiano.

Altre indicazioni sulle scelte di instradamento sono in instradamento per paese nell'OTP.

Passaggi per il personale operativo che usa la dashboard

Nessun codice richiesto: apri l'OTP Gateway, scegli Sudafrica e il servizio, controlla il prezzo mostrato, conferma e incolla il numero +27 nell'app. L'SMS compare nella pagina dell'attivazione appena arriva, e la finestra di 20 minuti con il rimborso automatico funziona esattamente come via API.

Risoluzione dei problemi: codici sudafricani in ritardo

Prima di tutto, il lato economico: se entro 20 minuti non arriva alcun SMS, o se annulli, l'intero importo torna automaticamente al wallet. Poi fai la diagnosi:

• Prima la pazienza. La velocità di consegna dipende dal servizio e dalla rotta, quindi lascia che l'attivazione faccia il suo corso.
• Politica di accettazione. Alcuni servizi rifiutano i numeri virtuali; in quel caso un rimborso è un comportamento atteso, non un guasto.
• Altro orario o altra rotta. Riprova più tardi, oppure usa una rotta vicina come Namibia o Botswana quando il caso di test lo consente.
• Niente martellamento. Annullare e riordinare in un ciclo serrato raramente aiuta e consuma il tuo rate limit.

Usa i numeri solo per testare il tuo prodotto o gestire i tuoi account aziendali, rispetta i termini di ogni servizio e ricorda che si applica l'Acceptable Use Policy di OTP Route.

Linee sudafricane a lungo termine e modello di fatturazione

Non esiste un numero +27 a lungo termine in self-service. I Dedicated Number, da $1.95/mese, sono offerti solo negli Stati Uniti e in Canada; i team che hanno bisogno di una linea sudafricana permanente possono scrivere a [email protected], e la fattibilità dipende dalle norme locali. La fatturazione è a consumo dal wallet prepagato, con una fattura PDF inviata via email per ogni ricarica. Vedi i prezzi per il quadro completo.

Domande frequenti

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

Sì. Ordina un numero +27 tramite l'OTP Gateway e leggi il codice nella dashboard o via API. Costa da $0.20 a codice, e solo quando il codice arriva.

Devo tenere lo 0 iniziale convertendo un numero sudafricano in E.164?

No. Elimina lo 0 del prefisso di rete e anteponi +27, così 082 123 4567 diventa +27821234567.

Qual è l'id paese API per il Sudafrica?

È za, che va nella query dei prezzi e nel corpo JSON quando crei un'attivazione +27.

In che lingua sono i testi di verifica sudafricani?

Per lo più in inglese, anche se il paese ha diverse lingue ufficiali. La formulazione è decisa dal servizio mittente.

C'è un rimborso se il codice non viene mai consegnato?

Sì. L'attivazione resta aperta 20 minuti e, se non arriva nulla o se annulli, l'intero importo torna automaticamente al tuo wallet.

Posso comprare un numero sudafricano da tenere per mesi?

Non in self-service. I Dedicated Number sono un prodotto per Stati Uniti e Canada; per il Sudafrica scrivi al supporto per chiedere, senza alcuna promessa di disponibilità.

Quanti servizi posso verificare con un numero +27 su OTP Route?

Più di 1.700 all'ultima istantanea. Controlla il catalogo in tempo reale tramite l'API, perché la disponibilità cambia nel corso della giornata.

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.