Una checklist preliminare per i numeri di verifica delle Isole Cayman

Checklist preliminare: cosa deve essere pronto prima di ordinare un numero +1 345?

Scorri questo elenco una volta sola e la prima attivazione per le Cayman tende a filare liscia:

• Account e sicurezza. Registrati con un indirizzo email e un codice email a 6 cifre (o con l'accesso Google), poi attiva l'autenticazione a due fattori TOTP per chiunque possa spendere dal wallet.
• Wallet con credito. Ricarica il wallet prepagato in USD con carta o con USDT/USDC. Non c'è un piano da scegliere né un canone mensile.
• Chiave API. Crea una chiave nella console sviluppatori; inizia con or_live_ e va in un header Bearer. Un account può avere fino a 10 chiavi.
• Endpoint webhook. Registra un URL e conserva il suo secret in un posto che il tuo handler possa leggere. Il limite è di cinque endpoint per account.
• Parsing dei telefoni configurato. Assicurati che la tua libreria di numeri associ il prefisso di zona 345 alle Isole Cayman invece di attribuire agli Stati Uniti ogni numero +1.
• Sandbox, se vuoi una prova a secco. Chiedi all'assistenza di passare un account di sviluppo alla modalità sandbox, così numeri e codici simulati mettono alla prova la tua integrazione senza toccare i fondi del wallet.

Il riferimento API elenca ogni campo che vedrai nelle risposte.

Perché un numero delle Cayman manda in crisi il codice che presume che +1 significhi America?

Le Isole Cayman fanno parte del North American Numbering Plan, quindi condividono il prefisso paese 1 con Stati Uniti, Canada e un lungo elenco di territori caraibici. Ciò che identifica una linea delle Cayman è il prefisso di zona 345. Un numero completo ha dieci cifre dopo il prefisso paese, si scrive localmente (345) NXX-XXXX e si memorizza in E.164 come +1345 seguito da sette cifre.

Tre conseguenze pratiche per gli ingegneri:

• Il rilevamento della regione deve guardare il prefisso di zona. Un modulo di registrazione che deduce il paese dal solo prefisso +1 etichetterà un cliente delle Cayman come americano e potrebbe scegliere il fuso orario, la valuta o il testo di consenso sbagliati.
• Nel NANP l'1 iniziale funge anche da cifra di prefisso interurbano, quindi gli utenti a volte digitano 1 345... o solo 345.... Normalizza tutte e tre le forme nella stringa E.164 prima del salvataggio.
• Salva i numeri senza spazi, trattini o parentesi e formattali solo al momento della visualizzazione.

L'inglese è la lingua ufficiale, quindi i codici per questo mercato di solito arrivano in inglese. La formulazione esatta, però, la decide il servizio che invia il messaggio, non la rotta.

Quali servizi possono instradare codici verso un numero di verifica delle Isole Cayman?

L'istantanea live per il paese ky comprende attualmente WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix ed eBay. Contando la coda lunga, la rotta copre più di 600 servizi e l'elenco cambia durante la giornata: per questo la disponibilità si legge sempre dall'API invece di essere fissata nel codice.

I team di solito hanno bisogno di un numero +1 345 per i test perché le isole sono un importante centro finanziario offshore e una frequentata meta turistica. Amministratori di fondi, assicuratori, piattaforme di viaggio e imprese immobiliari fanno l'onboarding di clienti locali, e i loro team di prodotto vogliono vedere il flusso di registrazione comportarsi come lo vivrebbe un residente delle Cayman. Le note sull'onboarding fintech trattano questo schema più a fondo.

Passo dopo passo: come si svolge la sequenza di chiamate dell'API OTP per le Isole Cayman?

Tutte le chiamate vanno a https://otproute.com/api/v1 con la tua chiave Bearer, entro un limite di 300 richieste al minuto.

1. Chiama GET /api/v1/services una volta e metti in cache gli id di servizio che servono alla tua suite di test.
2. Chiama GET /api/v1/prices?country=ky&service=<id> per leggere il prezzo live e confermare che la coppia sia disponibile in questo momento.
3. Invia POST /api/v1/activations con un corpo come {"service": "<id>", "country": "ky"}. La risposta contiene l'id di attivazione e il numero +1 345.
4. Inserisci quel numero nell'app sotto test e fai partire il suo passaggio SMS.
5. Attendi activation.sms_received sul tuo webhook. Controlla prima l'header X-OTPRoute-Signature: calcola l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint, confrontalo con v1 e rifiuta i timestamp vecchi.
6. Senza webhook, fai polling su GET /api/v1/activations/{id} a intervalli moderati finché compare il codice o la finestra si chiude.
7. Se il test si interrompe, chiama POST /api/v1/activations/{id}/cancel così l'importo trattenuto torna nel wallet.

La guida HMAC per i webhook spiega i controlli di firma riga per riga.

Passo dopo passo per i colleghi che preferiscono la dashboard

Il personale di assistenza e gli account manager non hanno bisogno di toccare l'API:

1. Apri la pagina dell'OTP Gateway nella dashboard.
2. Scegli le Isole Cayman come paese, poi il servizio che stai verificando.
3. Controlla il prezzo mostrato prima di ordinare e conferma.
4. Copia il numero nell'app, richiedi il codice e lascia aperta la pagina dell'attivazione; l'SMS compare lì quando arriva.

La finestra di 20 minuti e il rimborso valgono esattamente come tramite l'API.

Risoluzione dei problemi: cosa fare se nessun codice raggiunge il numero +1 345?

Per un'attivazione rimasta muta non viene addebitato nulla. Se nessun SMS arriva prima dello scadere dei 20 minuti, oppure annulli, l'intero importo torna da solo nel wallet. Prima di ordinare di nuovo:

• Lascia scorrere la finestra. Il tempo di consegna dipende dal servizio e dalla rotta, quindi un codice lento non è necessariamente un codice fallito.
• Controlla la policy del servizio. Alcuni servizi rifiutano del tutto i numeri virtuali, ed è proprio la situazione per cui esiste il rimborso.
• Riprova più tardi o cambia rotta. L'inventario cambia durante la giornata; un secondo tentativo un'ora dopo, o un paese caraibico vicino, può comportarsi in modo diverso.
• Evita i cicli serrati. Uno script che annulla e riordina ogni pochi secondi consuma il tuo limite di richieste e raramente aiuta.

Il manuale sulle consegne fallite offre altri strumenti diagnostici. Usa ogni numero solo per il tuo prodotto o per i tuoi account aziendali, rispetta i termini di ogni servizio e ricorda che si applica l'Acceptable Use Policy di OTP Route.

Posso tenere a lungo una linea delle Cayman e come funziona la fatturazione?

Per le Isole Cayman non esiste un numero a lungo termine in self-service. Condividere il prefisso paese +1 non cambia le cose: i Numeri Dedicati sono un prodotto solo per Stati Uniti e Canada, da $1.95/month, con SMS in entrata, SMS in uscita e chiamate dal browser. Se il tuo team ha bisogno di una linea 345 permanente, scrivi a [email protected]; la disponibilità dipende dalle norme locali e non è promessa.

Tutto il resto funziona con un unico wallet prepagato in USD. Le ricariche con carta o USDT/USDC producono ciascuna una fattura PDF via email, e la pagina dei prezzi spiega il modello pay-as-you-go.

Domande frequenti

Posso testare il flusso di registrazione della mia app per le Isole Cayman senza una SIM locale?

Sì. Ordina un numero +1 345 tramite l'OTP Gateway, inseriscilo nella tua app e leggi il codice nella dashboard o tramite l'API. Paghi da $0.20 per codice e solo quando il codice arriva.

Quale id paese usa l'API per le Isole Cayman?

L'id è ky. Passalo come valore di country quando chiami GET /api/v1/prices o POST /api/v1/activations.

Come devo memorizzare nel database un numero telefonico delle Cayman?

Salvalo in formato E.164: +1345 seguito dal numero di abbonato di sette cifre, senza spazi né punteggiatura. Riconosci il territorio dal prefisso di zona 345, non dal prefisso +1.

Un numero +1 345 conta come numero statunitense per i Numeri Dedicati?

No. I Numeri Dedicati si vendono solo per Stati Uniti e Canada, quindi una linea delle Cayman è disponibile soltanto come attivazione monocodice dell'OTP Gateway.

Cosa succede al mio denaro se l'SMS non arriva mai?

L'attivazione resta aperta per 20 minuti. Se in quel tempo non arriva alcun codice, oppure annulli prima, l'intero importo viene restituito automaticamente al tuo wallet.

Posso eseguire test OTP per le Cayman in CI senza spendere fondi del wallet?

Chiedi all'assistenza di passare un account di sviluppo alla sandbox. Restituisce numeri e codici simulati, così la tua pipeline può mettere alla prova l'intero flusso di attivazione e webhook a costo zero.

Quanti servizi delle Cayman copre OTP Route?

Più di 600 al momento dell'ultima istantanea. Poiché l'inventario cambia durante la giornata, interroga GET /api/v1/services e l'endpoint dei prezzi per la disponibilità live.

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.