Menerima OTP Zalo pada nomor OTP Route lewat API

Seperti apa alur API kode verifikasi Zalo?

Id layanannya adalah zalo. Panggilan dikirim ke https://otproute.com/api/v1 dengan kunci Bearer berawalan or_live_, yang diterbitkan di Developer console.

1. Ambil id negara dari GET /api/v1/countries; Vietnam, misalnya, adalah vn.
2. Periksa harga dan ketersediaan terkini dengan GET /api/v1/prices?country=vn&service=zalo.
3. Buat aktivasi: POST /api/v1/activations dengan {"service": "zalo", "country": "vn"}. Simpan id aktivasi dan nomor yang dikembalikan.
4. Masukkan nomor itu pada layar telepon Zalo di akun uji yang Anda kendalikan.
5. Ambil kode lewat webhook atau polling, atau akhiri pesanan dengan POST /api/v1/activations/{id}/cancel.

Cek saldo dengan GET /api/v1/balance di awal rangkaian pengujian untuk menghindari kejutan di tengah proses. Lihat dokumentasi API untuk bentuk permintaan selengkapnya.

Membangun penerima webhook untuk kode Zalo

Daftarkan endpoint di Developer console dan berlangganan activation.sms_received, activation.expired, dan activation.cancelled. Setiap permintaan memiliki header X-OTPRoute-Signature berbentuk t=<unix>,v1=<hex>; hitung HMAC-SHA256 atas <t>.<raw body> memakai secret endpoint, bandingkan dalam waktu konstan, dan tolak timestamp yang sudah lama.

Buat handler idempoten dengan menyimpan hasil berdasarkan id aktivasi. Jika peristiwa yang sama terkirim dua kali, penulisan kedua tidak boleh berdampak apa pun. Tim tanpa endpoint publik dapat melakukan polling GET /api/v1/activations/{id}; batas 300 permintaan per menit menyisakan ruang untuk interval polling yang singkat di beberapa pengujian paralel.

Kapan Zalo meminta nomor telepon?

Zalo adalah aplikasi pesan dan sosial dari Vietnam, dan nomor telepon berperan sebagai pengenal utama akun. Kode biasanya diminta saat seseorang membuat akun, saat masuk di perangkat baru, dan saat memulihkan akses. Langkah persisnya ditentukan oleh Zalo dan bisa berubah, jadi rencana pengujian sebaiknya mencakup setiap layar, bukan mengasumsikan satu urutan tetap.

Bagi tim QA, hal ini penting karena integrasi pesan, mini app, atau kanal dukungan pelanggan yang dibangun di sekitar Zalo sering membutuhkan akun uji yang baru dan terverifikasi sebelum skenario lain bisa dijalankan.

Negara mana saja yang bisa menerima OTP Zalo di OTP Route?

Rute Zalo terdaftar di 198 negara. Di antaranya Vietnam, Amerika Serikat, Jepang, Korea Selatan, Taiwan, Australia, Kanada, Kamboja, Laos, Thailand, Malaysia, Singapura, Jerman, Prancis, dan Inggris.

Pilih negara yang sesuai dengan akun yang Anda uji. Peluncuran di Vietnam membutuhkan nomor +84 untuk mereproduksi apa yang dilihat pengguna lokal, sedangkan tim yang melayani komunitas Vietnam di perantauan mungkin menginginkan nomor dari negara tempat pelanggan tersebut tinggal. Negara juga memengaruhi harga dan ketersediaan, karena itu endpoint harga layak diperiksa lebih dulu.

Langkah di dashboard untuk uji verifikasi SMS Zalo

Tidak semua orang di proyek menulis kode. Di dashboard, pilih Zalo sebagai layanan, pilih negara, konfirmasi harga yang ditampilkan, lalu pesan. Salin nomor ke Zalo; kode muncul di samping pesanan begitu SMS masuk. Membatalkan dari layar yang sama mengembalikan seluruh jumlahnya. Pendaftaran dashboard sendiri hanya memerlukan alamat email dan kode email 6 digit, atau masuk dengan Google, dan TOTP dua faktor dapat melindungi login tim.

Mengapa kode Zalo bisa tidak tiba?

Pengiriman bergantung pada layanan dan rute, jadi tidak ada waktu tunggu yang pasti. Zalo juga dapat menolak sebagian nomor virtual, dan itulah alasan adanya pengembalian dana. Jika tidak ada yang muncul:

• Biarkan pesanan terbuka sampai jendela 20 menit berakhir, atau batalkan; dalam kedua kasus uangnya kembali ke dompet.
• Coba lagi nanti, atau beralih ke negara lain yang sesuai dengan pengujian.
• Jangan memesan ulang dalam putaran cepat; tambahkan backoff pada tugas otomatis.
• Pastikan akun uji itu sendiri tidak diblokir atau dibatasi lajunya di sisi Zalo.

Haruskah akun uji Zalo memakai Dedicated Number?

Nomor OTP Gateway hanya menangani satu kode. Jika akun staging atau dukungan harus masuk lagi bulan depan, Dedicated Number lebih cocok: jalur AS atau Kanada mulai dari $1.95/month yang Anda pertahankan selama diperpanjang, dengan SMS masuk di dashboard dan pada webhook number.sms_received. Pelajari lebih lanjut di nomor virtual.

Gunakan kedua opsi secara bertanggung jawab. Patuhi ketentuan Zalo, jaga satu akun per orang atau bisnis nyata, dan gunakan OTP Route hanya untuk menguji dan mengoperasikan akun serta produk Anda sendiri yang sah. Zalo adalah merek dagang pemiliknya, dan OTP Route tidak berafiliasi dengannya.

Pertanyaan umum

Id layanan apa yang dipakai API OTP Route untuk Zalo?

Id-nya zalo, dikirim dalam body POST /api/v1/activations bersama id negara.

Bisakah saya menerima OTP Zalo pada nomor di luar Vietnam?

Bisa. Rute Zalo terdaftar di 198 negara, dan ketersediaan tiap negara dikembalikan secara langsung oleh endpoint harga.

Apakah saya ditagih jika Zalo menolak nomor virtual?

Tidak. Jika tidak ada kode yang masuk ke nomor dalam 20 menit, atau Anda membatalkan, seluruh jumlahnya dikembalikan ke dompet.

Apakah nomor virtual untuk Zalo cocok untuk akun yang saya perlukan jangka panjang?

Nomor sekali pakai tidak cocok. Untuk login berulang, Dedicated Number AS atau Kanada yang Anda pertahankan selama diperpanjang adalah pilihan yang lebih aman.

Bagaimana cara membayar verifikasi SMS Zalo untuk pengujian?

Isi dompet USD prabayar dengan kartu atau USDT/USDC; tidak ada biaya bulanan, dan setiap isi ulang disertai faktur PDF.

Bisakah saya mencoba integrasi Zalo tanpa mengeluarkan uang?

Bisa. Setelah dukungan mengalihkan akun pengembangan ke sandbox, pesanan Zalo mengembalikan nomor dan kode simulasi, sehingga kode webhook dan polling dapat dibuktikan sebelum pengeluaran sungguhan.

Nama layanan adalah merek dagang milik pemiliknya masing-masing. OTP Route tidak berafiliasi dengan mereka. Gunakan nomor secara sah, patuhi ketentuan tiap layanan dan Kebijakan Penggunaan yang Dapat Diterima kami.