Testare e operare con i codici di verifica +376 in Andorra

Perché i numeri andorrani mettono in difficoltà i moduli di registrazione?

Andorra usa il prefisso internazionale +376 e non ha prefisso di rete, quindi non c'è alcuno zero iniziale da eliminare. La maggior parte dei numeri di abbonato è lunga solo sei cifre, molto meno dei numeri nazionali di nove cifre usati nella vicina Spagna e in Francia. È la prima cosa che un ingegnere QA dovrebbe testare: le regex scritte a mano e le vecchie regole di validazione spesso richiedono sette o più cifre e scartano in silenzio un cellulare andorrano perfettamente valido.

Una regola pratica di archiviazione:

• Salva il numero in E.164 come +376 seguito dalle sei cifre, senza spazi né punteggiatura.
• Formatta per la visualizzazione solo al momento del rendering, ad esempio in due gruppi di tre.
• Tieni aggiornata la tua libreria di metadati telefonici, così le sue regole di lunghezza per AD corrispondono alla realtà.

Ordinare un numero +376 per i test è il modo più rapido per dimostrare che il tuo modulo, la colonna del database e il percorso di invio SMS accettano davvero un numero così breve, dall'inizio alla fine.

Quali lingue e abitudini dei clienti contano nel Principato?

Il catalano è la lingua ufficiale, e spagnolo, francese e portoghese si sentono spesso nei negozi e negli uffici. Le grandi app globali di solito inviano il testo di verifica nella lingua dell'account o del dispositivo dell'utente, quindi un codice può arrivare in inglese, spagnolo, francese o catalano a seconda del servizio. Se il tuo prodotto invia OTP a utenti andorrani, controlla che il modello in catalano venga reso correttamente e che le cifre siano facili da individuare.

I team lavorano con Andorra per alcuni motivi ricorrenti: attività di commercio, turismo e stagione sciistica che fanno l'onboarding di visitatori e residenti, aziende registrate nel Principato che hanno bisogno di un caso di test locale e prodotti transfrontalieri che servono persone che vivono su un lato dei Pirenei e lavorano sull'altro. Un bug comune è un selettore di paese che nasconde Andorra o la associa in silenzio a Spagna o Francia; un vero numero di verifica +376 lo fa emergere subito.

Quali servizi possono consegnare un codice su una route +376?

La route Andorra è un catalogo più piccolo rispetto ai grandi mercati, con più di 50 servizi nell'elenco live. Tra le voci popolari dell'istantanea attuale ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Viber, Netflix e Airbnb.

Poiché la disponibilità cambia durante il giorno, considera questo elenco un'istantanea e non una promessa. Controlla il catalogo live prima di un'esecuzione di test e, se un servizio che ti serve non è elencato per ad, confronta le route vicine nella pagina dei paesi o leggi la nostra nota sul routing per paese degli OTP.

Che aspetto ha la sequenza di chiamate dell'API OTP per Andorra?

Crea una chiave Bearer (prefisso or_live_) nella Developer console, poi lavora su https://otproute.com/api/v1. Un'esecuzione tipica è questa:

1. Chiama GET /api/v1/prices?country=ad&service=telegram per confermare che la route è aperta e vedere il prezzo aggiornato.
2. Invia POST /api/v1/activations con {"service": "telegram", "country": "ad"} e conserva l'id di attivazione e il numero restituiti.
3. Fai partire l'SMS di verifica dall'app o dal flusso che stai testando.
4. Attendi il webhook activation.sms_received, oppure fai polling su GET /api/v1/activations/{id} a intervalli moderati.
5. Se il test viene abbandonato, chiama POST /api/v1/activations/{id}/cancel così i fondi tornano subito.

Ogni webhook porta un'intestazione X-OTPRoute-Signature. Ricalcola l'HMAC-SHA256 del timestamp, un punto e il corpo grezzo con il segreto del tuo endpoint, confrontalo e scarta i timestamp scaduti. Gli account hanno fino a 10 chiavi, 5 endpoint webhook e 300 richieste al minuto. La documentazione API copre il resto di questa API di verifica SMS.

Un collega operativo può fare lo stesso senza codice?

Sì. Chiunque nel team può usare la dashboard al posto dell'API OTP per Andorra:

1. Accedi e apri l'OTP Gateway.
2. Scegli Andorra e il servizio che ti serve.
3. Controlla il prezzo mostrato, poi ordina il numero.
4. Incolla il numero +376 nel servizio e richiedi il codice.
5. Tieni aperta l'attivazione a schermo; il codice +376 viene mostrato nel momento in cui arriva.

Questa strada va bene al personale di assistenza che verifica un account aziendale o a un product manager che fa una dimostrazione una tantum di una registrazione localizzata.

Cosa deve succedere quando un codice +376 non arriva?

Ogni attivazione resta aperta 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.

Quando non compare nulla, lascia scorrere la finestra invece di riordinare subito, e verifica che il servizio accetti numeri virtuali, dato che alcuni li rifiutano. Poi riprova più tardi o prova la route di un altro servizio. Evita di riordinare in un ciclo serrato da uno script; aggiungi un backoff e un limite massimo. La nostra guida alla riduzione delle consegne OTP fallite elenca altri controlli.

Esiste una linea andorrana a lungo termine e come funziona la fatturazione?

Per Andorra non esiste un numero a lungo termine in self-service. I numeri dedicati si vendono all'istante solo negli Stati Uniti e in Canada, da $1.95/mese, tramite i numeri virtuali. Se il tuo team ha bisogno di una linea +376 duratura, scrivi a [email protected] e chiedi; la disponibilità dipende dalle norme locali e non è assicurata.

La fatturazione passa da un unico portafoglio USD prepagato, senza canone mensile e senza piani da scegliere. Ricarica con carta o con USDT/USDC, e ogni ricarica arriva con una fattura PDF via email; vedi i prezzi. Per il lavoro di integrazione, un account di sviluppo può essere portato in sandbox su richiesta, così la logica di routing OTP si testa con numeri e codici simulati. Usa le route reali solo per i tuoi account legittimi, rispetta i termini di ogni servizio e ricorda che vale l'Acceptable Use Policy di OTP Route.

Domande frequenti

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

Sì. Ordina un numero di Andorra dall'OTP Gateway, inseriscilo nel modulo di registrazione e leggi il codice nella dashboard o tramite l'API.

Qual è l'id del paese Andorra nell'API di OTP Route?

Usa ad come valore country nelle richieste di prezzo e di attivazione.

Quanto costa ricevere codici SMS OTP da Andorra?

I prezzi partono da $0.20 per codice e dipendono dal servizio. Il valore esatto viene restituito da GET /api/v1/prices e mostrato nella dashboard prima dell'ordine.

I numeri andorrani richiedono uno zero iniziale?

No. Andorra non ha prefisso di rete, quindi il numero è semplicemente +376 seguito dalle cifre dell'abbonato, di solito sei.

Posso tenere lo stesso numero +376 per accessi ripetuti?

Non come prodotto in self-service. I numeri del Gateway valgono per un solo codice; per una linea duratura fuori da Stati Uniti e Canada, scrivi a [email protected] per chiedere.

I nostri sviluppatori possono prototipare l'integrazione per Andorra senza toccare i fondi del portafoglio?

Sì. Chiedi al supporto di passare un account di sviluppo in sandbox, che restituisce numeri e codici simulati.

Mi viene addebitato qualcosa se Telegram non invia mai il codice?

No. Se nessun SMS arriva entro 20 minuti, o se annulli prima, l'importo viene rimborsato automaticamente nel tuo portafoglio.

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.