La strada di uno sviluppatore verso i codici di verifica giordani (+962)

Che aspetto ha la sequenza di richieste per un numero +962?

L'API di verifica SMS è un semplice REST su https://otproute.com/api/v1, con chiavi Bearer con prefisso or_live_ che generi nella console Developer. Ecco l'ordine che seguono la maggior parte delle integrazioni per la Giordania:

1. Scoperta: GET /api/v1/services e GET /api/v1/countries restituiscono gli identificatori. La Giordania è jo; un servizio come Telegram è telegram.
2. Controllo del prezzo: GET /api/v1/prices?country=jo&service=telegram restituisce quanto costa quell'abbinamento in questo momento e se può essere ordinato.
3. Ordine: POST /api/v1/activations con {"service": "telegram", "country": "jo"} riserva un numero e restituisce il suo id di attivazione.
4. Raccolta: fai polling su GET /api/v1/activations/{id} ogni pochi secondi, oppure lascia che sia il webhook a inviarti il risultato.
5. Pulizia: POST /api/v1/activations/{id}/cancel libera un'attivazione che non ti serve più e la rimborsa.

GET /api/v1/balance è utile come controllo all'inizio di un'esecuzione di test, così un job fallisce subito con un messaggio chiaro quando il portafoglio è scarico. Il riferimento completo è nella documentazione.

Come confermo che un webhook arrivi davvero da OTP Route?

Ogni evento (ad esempio activation.sms_received o activation.expired) arriva con un'intestazione X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Il tuo server calcola l'HMAC-SHA256 su "<t>.<raw body>" usando il secret di quell'endpoint e confronta il risultato con v1. Rifiuta la richiesta se i valori differiscono o se t è troppo nel passato: questo ferma i replay.

Poiché i nuovi tentativi possono consegnare due volte lo stesso evento, indicizza l'elaborazione sull'id dell'attivazione e tratta una seconda copia come un'operazione nulla. Il polling resta comunque un'alternativa valida per lo sviluppo locale, dove un URL webhook pubblico è scomodo. L'articolo sulla cattura degli OTP via webhook tratta code e nuovi tentativi.

Quali app si possono verificare su una rotta giordana?

Per la Giordania sono elencati più di 1.700 servizi. Tra i più scelti ci sono WhatsApp, Telegram, Facebook, Instagram, Snapchat, TikTok, X (Twitter), Discord, Claude, Microsoft & Outlook, Amazon, Viber, imo, Signal e LinkedIn.

L'elenco è un'istantanea, non una promessa. La capacità dei vettori cambia nel corso della giornata, quindi l'API riporta la disponibilità in tempo reale e il tuo codice dovrebbe leggerla prima di ordinare.

Formattare i numeri giordani: zero di linea, E.164 e testo in arabo

Il prefisso paese della Giordania è +962 e il prefisso di linea è 0. A livello locale un cellulare si scrive a partire da 07; in forma internazionale lo zero sparisce, lasciando +962 seguito da nove cifre che iniziano con 7. Salva la forma E.164 e, quando gli utenti incollano un numero locale, elimina lo 0 iniziale prima di aggiungere il prefisso paese. Confrontare come stringhe 07… e +9627… è una classica causa di bug di account duplicati.

L'arabo è la lingua ufficiale e molte persone impostano telefono e app in arabo. A seconda dell'app e della lingua dell'account, un codice può arrivare in un testo arabo o inglese. I messaggi in arabo vengono inviati in Unicode e le cifre possono trovarsi dentro testo da destra a sinistra, quindi estrai il codice con uno schema e testa entrambe le lingue.

I team lavorano con la Giordania quando localizzano un prodotto per chi parla arabo, gestiscono il supporto da Amman per la regione più ampia o controllano i flussi insieme a mercati vicini come l'Arabia Saudita e gli Emirati Arabi Uniti.

Ordinare un codice giordano dalla dashboard

Il personale operativo può fare la stessa cosa senza scrivere codice. Crea un account con email e un codice a sei cifre o con l'accesso Google, aggiungi fondi, scegli la Giordania e il servizio nell'OTP Gateway, conferma il prezzo mostrato e invia l'ordine. Il numero +962 compare subito e il codice appare accanto quando l'SMS arriva.

L'attivazione resta aperta per 20 minuti. Paghi solo se il codice arriva; se la finestra si chiude vuota o se annulli, l'importo viene riaccreditato automaticamente sul portafoglio.

Un ordine di debug per i codici che non arrivano

Parti dalla spiegazione più semplice e procedi verso l'esterno:

• La finestra è ancora aperta? La consegna dipende dal servizio e dalla rotta. Lascia scorrere tutti i 20 minuti prima di decidere che è fallita.
• Il servizio accetta numeri virtuali? Alcuni no, ed è per questo che le attivazioni inutilizzate vengono rimborsate.
• Prova un'altra rotta. Ordina di nuovo più tardi, oppure usa una diversa rotta di servizio per la stessa funzione se il tuo prodotto lo consente.
• Limita i nuovi tentativi. Un ciclo che rifà l'ordine ogni pochi secondi per lo più brucia tentativi; distanziali.

Testa solo account che possiedi o gestisci, rispetta le regole di ogni servizio e ricorda che la Acceptable Use Policy di OTP Route copre qualsiasi utilizzo.

Linee a lungo termine, portafoglio e sandbox

OTP Route non ha un numero giordano a lungo termine in self-service. I Dedicated Numbers, da $1.95/month, sono offerti subito solo negli Stati Uniti e in Canada. Se il tuo team ha bisogno di una linea +962 duratura, scrivi a [email protected]; la possibilità di organizzarla dipende dalle norme locali.

Il portafoglio è prepagato in USD, senza canone mensile e senza piano da scegliere. Ricarichi con carta o con USDT/USDC e ricevi una fattura PDF via email per ogni ricarica. Durante l'integrazione, chiedi la modalità sandbox per un account di sviluppo per ricevere numeri e codici simulati senza spendere fondi. Vedi i prezzi per le tariffe aggiornate.

Domande frequenti

Qual è il codice paese API per la Giordania?

Usa jo come valore di country nell'API di OTP Route, ad esempio in GET /api/v1/prices?country=jo&service=whatsapp.

Devo togliere lo 0 da un cellulare giordano?

Sì, per il formato internazionale. Un numero locale 07 diventa +962 seguito da nove cifre che iniziano con 7.

Un codice di verifica giordano arriverà in arabo?

Può succedere. La lingua di solito segue l'app e le impostazioni dell'account, quindi analizza le cifre con uno schema e testa sia messaggi in arabo sia in inglese.

Per quanto tempo un numero +962 resta riservato per il mio codice?

Ogni attivazione dura 20 minuti. Se in questo tempo non arriva alcun SMS, l'addebito torna sul tuo portafoglio.

Posso avere un numero dedicato giordano da tenere?

Non in self-service. I Dedicated Numbers sono un prodotto per Stati Uniti e Canada; per la Giordania puoi scrivere a [email protected] per chiedere.

C'è un modo per ricevere OTP SMS giordani nei test automatici?

Sì. Ordina con POST /api/v1/activations, poi fai polling sull'attivazione o gestisci il webhook firmato; un account sandbox ti permette di provare tutto con codici simulati.

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.