Ricevere gli OTP di Zalo sui numeri OTP Route tramite API

Che aspetto ha il flusso API del codice di verifica Zalo?

L'id del servizio è zalo. Le chiamate vanno a https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_, rilasciata nella console sviluppatori.

1. Ottieni gli id dei paesi da GET /api/v1/countries; il Vietnam, per esempio, è vn.
2. Controlla prezzo e disponibilità in tempo reale con GET /api/v1/prices?country=vn&service=zalo.
3. Crea l'attivazione: POST /api/v1/activations con {"service": "zalo", "country": "vn"}. Salva l'id dell'attivazione e il numero restituito.
4. Inserisci il numero nella schermata del telefono di Zalo, sull'account di test che controlli.
5. Ottieni il codice via webhook o con il polling, oppure chiudi l'ordine con POST /api/v1/activations/{id}/cancel.

Un controllo del saldo con GET /api/v1/balance all'avvio della suite evita sorprese a metà esecuzione. Consulta la documentazione API per la forma completa delle richieste.

Come costruire un ricevitore webhook per i codici Zalo

Registra un endpoint nella console sviluppatori e iscriviti a activation.sms_received, activation.expired e activation.cancelled. Ogni richiesta ha un'intestazione X-OTPRoute-Signature nel formato t=<unix>,v1=<hex>; calcola l'HMAC-SHA256 su <t>.<raw body> con il segreto dell'endpoint, confronta in tempo costante e scarta i timestamp vecchi.

Rendi il gestore idempotente salvando i risultati con l'id dell'attivazione come chiave. Se lo stesso evento viene consegnato due volte, la seconda scrittura non deve avere effetto. I team senza un endpoint pubblico possono invece fare polling su GET /api/v1/activations/{id}; il limite di 300 richieste al minuto lascia spazio a un intervallo di polling breve su più test in parallelo.

Quando Zalo chiede un numero di telefono?

Zalo è un'app vietnamita di messaggistica e social, e il numero di telefono funge da identificativo principale dell'account. Un codice viene di solito richiesto quando si crea un account, quando si accede da un nuovo dispositivo e quando si recupera l'accesso. Le richieste esatte le decide Zalo e possono cambiare, quindi un piano di test dovrebbe coprire ogni schermata invece di dare per scontata una sequenza fissa.

Per i team QA è importante perché un'integrazione di messaggistica, una mini app o un canale di assistenza costruito attorno a Zalo ha spesso bisogno di un account di test nuovo e verificato prima di poter eseguire qualsiasi altro scenario.

In quali paesi si può ricevere l'OTP di Zalo con OTP Route?

Le rotte Zalo sono elencate in 198 paesi. Tra questi ci sono Vietnam, Stati Uniti, Giappone, Corea del Sud, Taiwan, Australia, Canada, Cambogia, Laos, Thailandia, Malesia, Singapore, Germania, Francia e Regno Unito.

Scegli il paese che corrisponde all'account che stai testando. Un lancio in Vietnam richiede numeri +84 per riprodurre ciò che vedono gli utenti locali, mentre un team che serve le comunità vietnamite all'estero può volere numeri dei paesi in cui vivono quei clienti. Il paese incide anche su prezzo e disponibilità, ed è per questo che conviene controllare prima l'endpoint dei prezzi.

Passaggi dalla dashboard per un test di verifica SMS di Zalo

Non tutti in un progetto scrivono codice. Nella dashboard scegli Zalo come servizio, seleziona il paese, conferma il prezzo mostrato e ordina. Copia il numero in Zalo; il codice compare accanto all'ordine appena arriva l'SMS. Annullare dalla stessa schermata restituisce l'importo per intero. Per registrarsi alla dashboard bastano un indirizzo email e un codice email di 6 cifre, oppure l'accesso Google, e l'autenticazione a due fattori TOTP può proteggere l'accesso del team.

Perché un codice Zalo potrebbe non arrivare?

La consegna dipende dal servizio e dalla rotta, quindi non c'è un'attesa fissa. Zalo può inoltre rifiutare alcuni numeri virtuali, ed è il motivo per cui esiste il rimborso. Se non compare nulla:

• Lascia l'ordine aperto fino alla fine della finestra di 20 minuti, oppure annullalo; in entrambi i casi il portafoglio recupera i fondi.
• Riprova più tardi, oppure passa a un altro paese adatto al test.
• Non rifare l'ordine in un ciclo serrato; nei job automatici aggiungi un backoff.
• Verifica che l'account di test non sia bloccato o limitato da Zalo.

Un account di test Zalo dovrebbe usare un Numero Dedicato?

Un numero dell'OTP Gateway gestisce un solo codice. Se un account di staging o di assistenza deve accedere di nuovo il mese prossimo, il Numero Dedicato è la soluzione più adatta: una linea statunitense o canadese da $1.95/mese che tieni finché si rinnova, con SMS in entrata nella dashboard e sul webhook number.sms_received. Maggiori dettagli sui numeri virtuali.

Usa entrambe le opzioni in modo responsabile. Rispetta i termini di Zalo, tieni un account per ogni persona o azienda reale e usa OTP Route solo per testare e gestire i tuoi account e prodotti legittimi. Zalo è un marchio del suo titolare e OTP Route non è affiliata ad esso.

Domande frequenti

Quale id di servizio usa l'API di OTP Route per Zalo?

È zalo, inviato nel corpo di POST /api/v1/activations insieme a un id paese.

Posso ricevere un OTP di Zalo su un numero fuori dal Vietnam?

Sì. Le rotte Zalo sono elencate in 198 paesi e la disponibilità di ciascuno viene restituita in tempo reale dall'endpoint dei prezzi.

Mi viene addebitato qualcosa se Zalo rifiuta il numero virtuale?

No. Se nessun codice arriva sul numero entro 20 minuti, o se annulli, l'importo viene rimborsato per intero nel portafoglio.

Un numero virtuale per Zalo va bene per un account che mi serve a lungo termine?

Un numero monouso no. Per gli accessi ricorrenti, un Numero Dedicato statunitense o canadese che tieni finché si rinnova è la scelta più sicura.

Come pago la verifica SMS di Zalo per i test?

Ricarichi un portafoglio prepagato in USD con carta o USDT/USDC; non c'è canone mensile e ogni ricarica comprende una fattura PDF.

Posso provare l'integrazione Zalo senza spendere?

Sì. Dopo che il supporto ha portato un account di sviluppo alla sandbox, gli ordini Zalo restituiscono numeri e codici simulati, così il codice di webhook e polling può essere collaudato prima di spendere davvero.

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.