Ricevere codici di verifica +966 via API per i lanci in Arabia Saudita

Che aspetto ha una singola attivazione +966 via API?

Partiamo dalle chiamate, perché la maggior parte di chi legge questa pagina sta integrando un'API di verifica SMS in una suite di test o in uno strumento interno. Tutti gli endpoint si trovano sotto https://otproute.com/api/v1 e richiedono una chiave Bearer con prefisso or_live_, creata nella Developer console.

1. GET /api/v1/countries e GET /api/v1/services ti danno gli id. L'Arabia Saudita è sa.
2. GET /api/v1/prices?country=sa&service=<id> restituisce la tariffa in tempo reale per quella combinazione; registrala accanto all'esecuzione del test.
3. POST /api/v1/activations con {"service": "<id>", "country": "sa"} restituisce un id di attivazione e un numero +966.
4. Il tuo test inserisce il numero nell'app e il codice arriva come evento o tramite GET /api/v1/activations/{id}.
5. Se il test viene abbandonato, POST /api/v1/activations/{id}/cancel lo rilascia e rimborsa il wallet.

GET /api/v1/balance è utile come controllo preliminare, così un job notturno fallisce subito con un messaggio chiaro invece che a metà esecuzione. Limiti da considerare: 10 chiavi e 5 endpoint webhook per account, 300 richieste al minuto.

Come deve trattare il nostro ricevitore webhook gli eventi OTP sauditi?

Registra un endpoint e iscriviti a activation.sms_received, activation.expired e activation.cancelled. Ogni richiesta include X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>.

• Ricostruisci la stringa firmata come <t>.<raw body> e calcola HMAC-SHA256 con il segreto di quell'endpoint.
• Confrontala con v1 usando una funzione a tempo costante e rifiuta qualsiasi richiesta con un timestamp troppo vecchio.
• Considera ogni evento legato all'id dell'attivazione, in modo che una riconsegna non aggiorni nulla due volte.
• Rispondi in fretta con un 2xx e svolgi il lavoro lento in un job in background.

Il polling resta un'alternativa valida per i runner che non possono accettare connessioni in ingresso. I nostri approfondimenti su cattura OTP basata su webhook e protezione dei webhook OTP con HMAC vanno più a fondo.

Perché i team di prodotto testano con un numero +966?

L'Arabia Saudita è uno dei mercati digitali più grandi del Golfo, e i team arrivano a questa pagina per ragioni pratiche: una fintech che prepara l'onboarding per i residenti sauditi, un marketplace che aggiunge venditori del Golfo, un fornitore SaaS il cui cliente richiede un controllo di accesso regionale, o un team operativo che gestisce account aziendali per una sede a Riyad o Gedda. In ogni caso qualcuno deve dimostrare che il flusso funziona con un vero numero di verifica saudita, e l'instradamento OTP tramite il gateway evita di spedire SIM nella regione. La pagina sull'onboarding fintech descrive questo scenario più nel dettaglio.

Quali servizi possono ricevere codici sulle rotte saudite?

L'istantanea in tempo reale per l'Arabia Saudita copre più di 1.000 servizi. Tra quelli usati più spesso ci sono Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail e YouTube), Telegram, Amazon, Microsoft e Outlook, LinkedIn, Discord e Netflix. Snapchat e X hanno un pubblico particolarmente ampio nel Regno, il che li rende voci frequenti in una checklist di localizzazione. La disponibilità cambia durante la giornata, quindi interroga l'API al momento dell'esecuzione.

Come formatto i numeri +966 e analizzo i messaggi in arabo?

A livello locale, i numeri mobili sauditi si scrivono con uno 0 di prefisso interurbano, di solito come 05 seguito da otto cifre. La forma internazionale elimina quello zero: +966 5 e le restanti otto cifre. Normalizza tutto in E.164 al momento dell'inserimento ed elimina lo zero se un utente lo digita dopo il prefisso del paese.

L'arabo è la lingua ufficiale, quindi i messaggi di verifica possono arrivare in arabo, in inglese o in entrambe le lingue. L'arabo si scrive da destra a sinistra e alcuni modelli di messaggio possono usare cifre indo-arabe invece di quelle occidentali. Un parser che converte quelle cifre in ASCII prima del confronto e registra l'UTF-8 grezzo evita una fastidiosa categoria di falsi errori.

C'è un percorso dalla dashboard per chi non scrive codice?

Sì. Accedi a OTP Route, apri l'OTP Gateway, scegli Arabia Saudita e il servizio, controlla il prezzo e conferma. Il numero compare subito e il codice viene mostrato accanto a esso all'arrivo. Un agente del supporto può usarlo per riprodurre il problema di registrazione di un cliente in un paio di minuti.

Cosa succede se il codice non arriva, e che dire di linee a lungo termine e fatturazione?

Se nessun SMS arriva entro 20 minuti, o se annulli, l'intero importo torna automaticamente sul wallet. Lascia concludere la finestra, riprova più tardi o con un'altra rotta di servizio, verifica che il servizio accetti i numeri virtuali ed evita di riordinare a raffica.

Non esiste un numero saudita a lungo termine in self-service. I Numeri Virtuali Dedicati sono offerti solo negli Stati Uniti e in Canada, a partire da $1.95/month; per una linea +966 a lungo termine scrivi a [email protected], tenendo presente che sono le norme locali a stabilire se sia possibile.

Il finanziamento avviene da un unico wallet prepagato in USD, a consumo e senza canone mensile. Per le ricariche funzionano sia le carte sia USDT/USDC, e ognuna genera una fattura PDF inviata via email. Su richiesta, un account di sviluppo può essere passato alla modalità sandbox per ottenere numeri e codici simulati. Consulta la pagina dei prezzi per le tariffe aggiornate.

Domande frequenti

Come ricevo un OTP SMS saudita tramite API?

Crea un'attivazione con paese sa e l'id del tuo servizio, poi prendi il codice dal webhook activation.sms_received o facendo polling sull'attivazione.

Un numero +966 per i test viene addebitato se il codice non arriva?

No. Se manca il codice, l'intero importo torna sul wallet quando la finestra di 20 minuti si chiude o quando annulli.

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

Sì. L'OTP Gateway ti assegna un numero +966 per un solo codice, che inserisci nella tua app e rileggi dalla dashboard o dall'API.

Come devo memorizzare un numero mobile saudita inserito come 05XXXXXXXX?

Elimina lo zero iniziale e salvalo come +966 5 più le restanti otto cifre in formato E.164.

Possiamo tenere lo stesso numero saudita per accessi futuri?

Non con un prodotto self-service, perché i Numeri Dedicati a lungo termine coprono solo Stati Uniti e Canada. Scrivi al team se ti serve una linea saudita, senza alcuna garanzia che possa essere fornita.

C'è un modo per provare il flusso saudita prima di usare denaro reale?

Sì. Chiedi la modalità sandbox su un account di sviluppo per ricevere numeri e codici simulati, webhook inclusi.

Quali usi consente OTP Route?

Testare e gestire i tuoi prodotti e account legittimi. Rispetta i termini di ogni servizio; si applica l'Acceptable Use Policy di OTP Route.

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.