Una checklist preliminare per ricevere SMS di Curaçao (+599)

Cosa deve esserci nella checklist prima di ordinare un numero +599?

I mercati insulari premiano un po' di preparazione, perché la disponibilità delle rotte cambia nel corso della giornata e un test affrettato fa perdere tempo. Spunta questi punti prima della prima richiesta:

• Una chiave API dalla Developer console. Le chiavi iniziano con or_live_; un account può averne fino a 10, quindi dai a CI e staging le loro.
• Un portafoglio in USD con fondi, oppure un account di sviluppo portato in sandbox su richiesta se vuoi solo provare l'integrazione.
• Gli id giusti. Curaçao è cw nell'API; l'id del servizio viene da GET /api/v1/services.
• Un endpoint webhook con il suo secret salvato, oppure un ciclo di polling con un intervallo ragionevole. Sono consentiti fino a 5 endpoint per account.
• Una regola di archiviazione per i numeri +599 (descritta più sotto), così i dati di test corrispondono a quelli di produzione.
• Un piano per il caso vuoto: che cosa fa il tuo test quando la finestra scade senza codice.

Quali servizi copre la rotta del numero di verifica di Curaçao?

Lo snapshot live per Curaçao elenca più di 400 servizi. Tra i più richiesti ci sono Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber e Airbnb. I nomi del turismo e della messaggistica sono quelli a cui i team di Curaçao ricorrono per primi, dato che ospitalità e prodotti rivolti ai visitatori generano molte registrazioni digitali sull'isola.

Considera questo elenco un punto di partenza, non una promessa. L'inventario cambia durante la giornata, ed è esattamente per questo che l'API restituisce la disponibilità a ogni consultazione dei prezzi.

Passo dopo passo: chiamare l'API OTP per Curaçao

Ogni chiamata va a https://otproute.com/api/v1 con la tua chiave Bearer, entro un tetto di 300 richieste al minuto.

1. Leggi GET /api/v1/prices?country=cw&service=<id> per confermare che la rotta sia aperta e vedere il prezzo attuale di quella coppia.
2. Crea l'ordine con POST /api/v1/activations, inviando {"service": "telegram", "country": "cw"} o l'id del servizio che ti serve. La risposta contiene un id di attivazione e il numero +599.
3. Inserisci quel numero nella schermata di registrazione o di accesso che stai testando.
4. Attendi activation.sms_received sul tuo webhook, oppure interroga GET /api/v1/activations/{id} a intervalli tranquilli.
5. Se il test viene abbandonato, chiama POST /api/v1/activations/{id}/cancel così il portafoglio viene riaccreditato subito.

Prima di fidarti di un webhook, controlla l'header X-OTPRoute-Signature: calcola l'HMAC-SHA256 su "<t>.<raw body>" con il secret dell'endpoint e rifiuta i timestamp obsoleti. La guida alla firma dei webhook lo spiega più a fondo.

Come va memorizzato e normalizzato un numero +599?

Curaçao condivide il prefisso +599 con Bonaire, Sint Eustatius e Saba, e i numeri di abbonato di Curaçao seguono quel prefisso con un 9. Quel 9 iniziale fa parte del numero, non è un prefisso interurbano, quindi un normalizzatore che lo elimina corromperà il record. Salva la stringa E.164 completa (+5999 seguito dalle cifre restanti) senza spazi e applica la formattazione solo in fase di visualizzazione.

Vale anche la pena controllare che il tuo widget di input telefonico elenchi Curaçao come voce a sé stante invece di accorparlo in una generica opzione Antille Olandesi, come fanno ancora le librerie più vecchie.

Quanto alla lingua: papiamento, olandese e inglese sono tutti ufficiali, e la maggior parte dei servizi globali invia i codici in inglese o nella lingua impostata sull'account. Se il tuo prodotto è localizzato in olandese o papiamento, esegui almeno un passaggio per lingua così vedi il template reale e non uno di ripiego. I team di solito testano qui quando lanciano nei Caraibi olandesi, servono visitatori che prenotano dall'estero o gestiscono operazioni regionali dall'isola.

Qual è il percorso dalla dashboard per chi non scrive codice?

Gli operatori del supporto e i product manager possono fare la stessa cosa senza alcuno script:

1. Crea un account con email e un codice a 6 cifre, oppure con l'accesso Google, e attiva l'autenticazione a due fattori TOTP.
2. Ricarica il portafoglio.
3. Apri l'OTP Gateway, scegli il servizio, poi Curaçao; il prezzo compare prima di confermare.
4. Copia il numero +599 nell'app e guarda la scheda dell'attivazione finché non compare il codice.

Valgono la stessa finestra di 20 minuti e la stessa regola di rimborso dell'API.

Risoluzione dei problemi: il codice di Curaçao non è comparso

Un'attivazione silenziosa ogni tanto è normale e non costa nulla, perché l'importo torna nel portafoglio quando la finestra si chiude o annulli.

• Lascia scorrere la finestra. Alcuni servizi rinviano lentamente; annullare al secondo minuto butta via un codice che potrebbe ancora arrivare.
• Controlla la posizione del servizio di destinazione sui numeri virtuali. Alcuni li rifiutano, ed è per questo che esiste il rimborso.
• Riprova più tardi, oppure prova un'altra rotta paese se il test non dipende specificamente da un numero di Curaçao.
• Evita di riordinare in un ciclo serrato. Lascia pause tra i tentativi per non accumulare attivazioni parallele per un solo test.

La pagina della soluzione QA testing mostra come i team integrano questi retry nelle suite automatizzate.

Linee a lungo termine, portafoglio e fatturazione per i progetti su Curaçao

Per Curaçao non esiste un numero a lungo termine in self-service. Se ti serve una linea da tenere per mesi, scrivi a [email protected] e il team verificherà che cosa consentono le norme locali; non viene promesso nulla. Le linee dedicate sono un prodotto per Stati Uniti e Canada, da $1.95/month, descritto nella pagina dei numeri virtuali.

Le attivazioni per Curaçao attingono a un unico portafoglio prepagato in USD, senza canone mensile e senza piani da scegliere. Per ricaricare funzionano sia i pagamenti con carta sia USDT/USDC, e ogni ricarica genera una fattura PDF via email per la contabilità del tuo progetto su Curaçao. Le tariffe attuali sono nella pagina dei prezzi. Usa OTP Route solo per i tuoi prodotti e account legittimi, rispetta i termini di ciascun servizio e ricorda che si applica la Acceptable Use Policy di OTP Route.

Domande frequenti

Posso testare una registrazione a Curaçao senza comprare una SIM locale?

Sì. Ordina un numero +599 dall'OTP Gateway per il servizio in prova e leggi il codice nella dashboard o via API, senza SIM né telefono sull'isola.

Quale id paese usa OTP Route per Curaçao?

Curaçao è cw. Abbina cw all'id del servizio elencato da GET /api/v1/services in ogni verifica dei prezzi e in ogni ordine.

Il 9 dopo +599 è un prefisso interurbano da eliminare?

No. Per Curaçao il 9 fa parte del numero di abbonato, quindi mantienilo nel valore E.164 memorizzato.

Mi viene addebitato qualcosa quando un'attivazione di Curaçao scade senza codice?

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

Posso tenere un numero di Curaçao per accessi ripetuti il mese prossimo?

Non in self-service. I numeri dedicati a lungo termine sono venduti solo per Stati Uniti e Canada; per Curaçao puoi scrivere al supporto per chiedere, senza alcuna promessa di disponibilità.

Come posso collegare l'integrazione prima di spendere fondi del portafoglio?

Richiedi la modalità sandbox per un account di sviluppo tramite il supporto. Restituisce numeri e codici simulati così l'intero percorso API e webhook può essere provato end to end.

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.