Ricevere codici SMS OTP della Nuova Zelanda via API o dashboard

Numero +64 temporaneo o linea a lungo termine: di quale ho bisogno?

Scegliere subito il prodotto giusto evita rifacimenti più avanti.

Scegli l'OTP Gateway quando un test o un passaggio di onboarding richiede esattamente un codice: un nuovo account QA, uno smoke test della tua schermata di registrazione neozelandese, una verifica end to end del flusso di un cliente kiwi. Ricevi un numero, un codice, e la sessione si chiude.

Scegli un Numero Dedicato quando lo stesso account deve accedere di nuovo dopo settimane o un team condivide un numero di recupero. Queste linee a lungo termine sono offerte solo negli Stati Uniti e in Canada, da $1.95/mese, con gli SMS in entrata inoltrati come eventi number.sms_received.

Per la Nuova Zelanda non esiste un numero a lungo termine in self-service. Scrivi a [email protected] se il tuo caso ne richiede uno; la risposta dipende dalle norme locali e potrebbe essere negativa. Chiamate, SMS in uscita e condizioni di rinnovo per queste linee nordamericane sono descritti nella pagina numeri virtuali.

Perché i team di prodotto testano le registrazioni in Nuova Zelanda?

La Nuova Zelanda è un mercato di soft launch molto diffuso per le app in lingua inglese: un pubblico più piccolo, una lingua familiare e un fuso orario anticipato ne fanno un luogo pratico per osservare l'onboarding reale prima di un rilascio più ampio. Ne consegue che il passaggio di verifica +64 è spesso il primo percorso di produzione che un nuovo mercato vede, e merita casi di test dedicati.

Vale la pena coprire alcuni aspetti:

• Lingua. Sono ufficiali l'inglese, il te reo māori e la lingua dei segni neozelandese. La maggior parte dei servizi invia i codici in inglese, ma se i tuoi template usano parole māori con i macron (ā, ō, ū), quei caratteri non rientrano in GSM-7 e portano l'SMS in UCS-2, accorciando ogni segmento.
• Confini dell'orologio. La Nuova Zelanda è tra i primi luoghi a entrare in un nuovo giorno di calendario, quindi la logica di scadenza e rate limit basata sulle date può comportarsi in modo diverso per gli utenti locali.
• Aderenza al mercato. Un account QA verificato con un numero locale esercita la stessa logica per paese che incontreranno i tuoi utenti kiwi.

Per un modello di release gate costruito su controlli di questo tipo, consulta le nostre note sul QA testing.

Come vanno salvati e normalizzati i numeri mobili +64?

La Nuova Zelanda usa il prefisso nazionale 0. Un numero mobile scritto in formato nazionale come 021 123 4567 diventa +64211234567 in E.164: elimini lo 0 iniziale e aggiungi +64. I prefissi mobili iniziano con 2 una volta tolto lo zero e la loro lunghezza varia, quindi non fissare mai nel codice un numero preciso di cifre.

Regole pratiche per il tuo schema:

• Salva una sola stringa E.164 canonica; formatta per la visualizzazione solo al momento del rendering.
• Accetta input con spazi, trattini o lo zero iniziale, poi normalizza con una libreria di parsing dei numeri di telefono mantenuta.
• Aggiungi fixture di test sia per la forma nazionale sia per quella internazionale, più un numero che un utente ha incollato con +64 e lo 0 ancora presente.

Quali app inviano codici ai numeri neozelandesi su OTP Route?

La route +64 supporta più di 800 servizi. Dall'istantanea attuale, tra quelli usati più spesso ci sono Google (Gmail e YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber e Netflix.

Poiché la disponibilità è in tempo reale, interroga GET /api/v1/countries e GET /api/v1/services all'inizio di ogni esecuzione invece di memorizzare un elenco per settimane. Se un servizio è poco presente sulla +64, la route vicina dell'Australia è di solito l'alternativa per un confronto in lingua inglese.

Com'è la sequenza dell'API OTP per la Nuova Zelanda?

Ogni chiamata +64 va a https://otproute.com/api/v1 con una chiave Bearer or_live_ emessa nella Developer console. La sequenza:

1. Leggi il prezzo aggiornato con GET /api/v1/prices?country=nz&service=uber.
2. Crea l'attivazione con POST /api/v1/activations e il corpo {"service": "uber", "country": "nz"}.
3. Raccogli il codice facendo polling su GET /api/v1/activations/{id}, oppure lascia che activation.sms_received arrivi al tuo webhook. activation.expired e activation.cancelled ti dicono quando ripulire.
4. Annulla gli ordini non usati con POST /api/v1/activations/{id}/cancel e tieni d'occhio i fondi con GET /api/v1/balance.

Per i webhook, verifica X-OTPRoute-Signature calcolando l'HMAC-SHA256 di <t>.<raw body> con il secret dell'endpoint, rifiuta i timestamp vecchi e rendi il gestore idempotente rispetto all'id di attivazione, così una consegna ritentata non causa danni. La guida all'integrazione offre un percorso più completo; il limite è di 300 richieste al minuto per account.

Una persona non sviluppatrice può ordinare un numero di verifica neozelandese?

Certamente. Nella dashboard scegli Nuova Zelanda, seleziona il servizio, controlla il prezzo mostrato e conferma. Il numero +64 compare nell'ordine; inseriscilo nell'app, richiedi l'SMS e il codice appare sulla stessa scheda quando arriva. Tutto avviene entro la finestra di 20 minuti, quindi tieni aperta l'app di destinazione prima di ordinare.

E se il codice +64 non arriva mai?

Concedi prima alla finestra tutti i suoi 20 minuti, perché alcuni mittenti ritardano o raggruppano i propri SMS. Se resta comunque vuota, il servizio potrebbe rifiutare i numeri virtuali, oppure quella route potrebbe essere occupata; riprova più tardi o prova con un'altra route di servizio invece di lanciare nuovi ordini a raffica. Gli ordini senza risposta, e quelli che annulli, vengono rimborsati automaticamente sul portafoglio. La fatturazione è a consumo da un portafoglio USD prepagato: ricariche con carta o USDT/USDC, una fattura PDF per ciascuna, nessun canone mensile e modalità sandbox su richiesta per le prove. OTP Route è pensato per i tuoi account e prodotti legittimi, nel rispetto dei termini di ogni servizio e della nostra Acceptable Use Policy.

Domande frequenti

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

Sì. Ordina un numero +64 sull'OTP Gateway, usalo nel modulo di registrazione e leggi il codice nella dashboard o tramite l'API.

Devo mantenere lo 0 quando salvo un numero mobile neozelandese?

No. Lo 0 del prefisso nazionale viene eliminato in E.164, quindi 021 123 4567 si salva come +64211234567.

Qual è l'id paese dell'API per la Nuova Zelanda?

È nz, usato nelle richieste di prezzo e nel corpo della richiesta di attivazione.

Quanto costa un codice di verifica neozelandese?

I prezzi partono da $0.20 per codice e dipendono dal servizio; la dashboard e GET /api/v1/prices mostrano la cifra esatta prima dell'ordine.

Posso noleggiare un numero neozelandese per qualche mese?

Non esiste una linea +64 a lungo termine in self-service. I Numeri Dedicati sono un prodotto per Stati Uniti e Canada, e puoi scrivere a [email protected] per informarti sugli altri paesi.

Meglio il polling o un webhook per raccogliere i codici +64?

Il polling è più semplice per un singolo script; un webhook firmato scala meglio quando molti job di test girano in parallelo. Entrambi restituiscono lo stesso codice.

Tutte le app accetteranno un numero neozelandese di OTP Route?

Non necessariamente. Alcuni servizi rifiutano i numeri virtuali, ed è per questo che un ordine senza SMS viene rimborsato automaticamente.

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.