Numeri di verifica del Regno Unito: checklist per testare gli OTP +44

Checklist: il tuo stack è pronto per i codici di verifica +44?

Ripassa questo elenco prima che una release candidate arrivi alla tappa britannica del tuo piano di test:

• [ ] Una chiave della Developer console (prefisso or_live_) limitata al job che la userà.
• [ ] L'id del paese per il Regno Unito, gb, inserito nelle tue fixture, più l'id del servizio da GET /api/v1/services.
• [ ] Una decisione sulla consegna: un webhook firmato per le suite in parallelo, oppure il polling per uno script veloce.
• [ ] Un parsing dei numeri di telefono che gestisca lo zero iniziale britannico (ne parliamo sotto).
• [ ] Saldo sufficiente, confermato con GET /api/v1/balance, oppure un account sandbox per le prove a vuoto.
• [ ] Una nota nel runbook che un numero serve esattamente un codice.

I team che lo integrano nelle pipeline troveranno utile come complemento l'articolo sui test SMS OTP nelle pipeline CI.

Come funziona il flusso dell'API OTP per il Regno Unito con l'id paese gb?

La sequenza ricalca ciò che farebbe a mano un tester umano, solo più veloce e tracciata:

1. Ottieni il prezzo della coppia con GET /api/v1/prices?country=gb&service=<id>; la risposta riflette la disponibilità live.
2. Riserva un numero con POST /api/v1/activations e {"service": "<id>", "country": "gb"}.
3. Inserisci il numero +44 nella schermata di registrazione, accesso o recupero e richiedi l'SMS.
4. Ricevi il codice tramite l'evento activation.sms_received oppure leggendo GET /api/v1/activations/{id}.
5. Interrompi in modo pulito con POST /api/v1/activations/{id}/cancel quando un test viene saltato.

Un handler di webhook dovrebbe trattare ogni richiesta come non attendibile finché l'intestazione X-OTPRoute-Signature non risulta corretta: l'HMAC-SHA256 di <t>.<raw body> con il segreto dell'endpoint deve coincidere con v1, e il timestamp deve essere recente. Salva i risultati usando come chiave l'id di attivazione, così le consegne duplicate sono innocue. I limiti sono generosi per la maggior parte delle suite: 300 richieste al minuto, fino a 10 chiavi e 5 endpoint webhook per account. Il riferimento completo è nella documentazione per sviluppatori.

Quali servizi e app sono disponibili sulla route britannica?

Il Regno Unito è una delle route più ampie, con più di 4.000 servizi disponibili. Tra le opzioni popolari ci sono WhatsApp, Google (Gmail & YouTube), Amazon, Uber, Netflix, eBay, Airbnb, LinkedIn, Microsoft & Outlook, Instagram, Snapchat, X (Twitter), Discord e ChatGPT (OpenAI).

Le route cambiano di ora in ora, quindi lascia che sia l'endpoint dei prezzi o la dashboard a dirti cosa si può ordinare adesso, invece di dare per valido il risultato di ieri.

Gestire lo zero iniziale: salvare in E.164 i cellulari britannici

Il Regno Unito usa un prefisso nazionale 0. Le persone scrivono il proprio cellulare come 07xxx xxxxxx, undici cifre, ma a livello internazionale lo 0 scompare e il numero diventa +447xxxxxxxxx. Il bug più comune nei campi telefono britannici è mantenere entrambi, il che produce una stringa non valida +4407… a cui nessun gateway SMS consegnerà.

Controlli da aggiungere alla tua suite di test:

• L'input 07… viene normalizzato in +447… prima di essere salvato.
• L'input già nella forma +44 7… passa invariato.
• Gli spazi nel familiare raggruppamento 07xxx xxxxxx vengono eliminati.
• La formattazione per la visualizzazione si applica solo in uscita e non viene mai salvata.

I messaggi di verifica per gli utenti britannici arrivano in inglese. Il gallese è anche lingua ufficiale in Galles, quindi i servizi rivolti al pubblico con un'interfaccia bilingue potrebbero voler verificare che modelli e schermate si comportino bene in entrambe le lingue.

Perché i team QA e di crescita testano con numeri britannici

Per molte aziende il Regno Unito è il mercato di casa o il primo fuori da esso. I prodotti finanziari in particolare tendono a mettere la verifica telefonica al centro dell'onboarding e dei controlli aggiuntivi, quindi un flusso +44 rotto emerge presto nelle code di supporto.

Motivi comuni per ordinare un numero +44 per i test:

• Un lancio nel Regno Unito, dove la build en-GB richiede un giro a sé per ortografia, formati di data e selettore del paese.
• Test di regressione su accesso e recupero dell'account dopo una modifica alle impostazioni del tuo provider SMS.
• Riprodurre la registrazione fallita di un cliente britannico per capire dove si è perso il codice.

La pagina sull'onboarding fintech descrive come i team strutturano questi controlli.

Risolvere il problema di un codice +44 mancante

Quando il codice non arriva, evita l'istinto di riordinare subito. Piuttosto:

1. Lascia concludere la finestra di 20 minuti; alcuni servizi trattengono i messaggi per un breve periodo.
2. Leggi lo stato dell'attivazione. Se termina come scaduta, non è arrivato nulla e l'intero importo è già tornato nel portafoglio.
3. Ricorda che alcuni servizi rifiutano i numeri virtuali. È proprio questo l'esito che la regola del rimborso copre.
4. Riprova dopo una pausa, o con un'altra route per lo stesso servizio, invece di ripetere gli ordini in un ciclo.
5. Conferma che la tua app abbia davvero inviato la richiesta di un SMS, e che sia andata al numero +44 che hai riservato e non a una fixture obsoleta.

Percorso dalla dashboard, fatturazione e linee britanniche a lungo termine

I non sviluppatori possono fare tutto questo senza codice: apri la dashboard, scegli Regno Unito e il servizio, conferma il prezzo mostrato, copia il numero nell'app e attendi il codice nella stessa pagina.

Non esiste un numero britannico a lungo termine in self-service. I Numeri dedicati sono un prodotto per Stati Uniti e Canada, da $1.95/mese; per una linea britannica persistente scrivi a [email protected] e il team spiegherà cosa consentono le norme locali, senza prometterlo. Tutto funziona con un portafoglio prepagato in USD senza canone mensile, ricaricato con carta o USDT/USDC, con fatture PDF via email. I dettagli sono nella pagina dei prezzi.

Domande frequenti

Posso testare il flusso di registrazione britannico della mia app senza una SIM del Regno Unito?

Sì. Richiedi un numero +44 all'OTP Gateway, inseriscilo nella schermata di registrazione e leggi il codice dalla dashboard, da un webhook o dall'endpoint dell'attivazione.

L'id paese del Regno Unito nell'API è `uk` o `gb`?

È gb, secondo il codice paese ISO.

Come converto un numero britannico che inizia con 07?

Elimina lo 0 iniziale e anteponi +44, così 07… diventa +447….

Pago un'attivazione britannica che va in timeout?

No. Se entro 20 minuti non arriva alcun SMS, oppure annulli, l'intero importo torna automaticamente nel tuo portafoglio.

OTP Route può darmi un numero britannico da tenere per mesi?

Non come prodotto self-service. I Numeri dedicati a lungo termine sono venduti solo per Stati Uniti e Canada; puoi scrivere al supporto per chiedere del Regno Unito, senza alcuna garanzia che sia possibile.

Posso provare prima l'integrazione britannica in una sandbox?

Sì. Un account di sviluppo può essere passato alla sandbox su richiesta, restituendo numeri e codici simulati così puoi testare senza spendere fondi del portafoglio.

Quali regole d'uso valgono per i numeri di verifica britannici?

Rispetta i termini di ciascun servizio e l'Acceptable Use Policy di OTP Route, e usa i numeri solo per i tuoi prodotti, test e account aziendali legittimi.

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.