Daftar Periksa Pra-Uji untuk Menerima Kode Verifikasi +372 di Estonia

Apa saja yang perlu ada di daftar periksa sebelum pesanan +372 pertama?

Kebanyakan uji coba yang gagal bermuara pada sesuatu yang kurang sebelum nomor itu diminta. Centang hal-hal ini lebih dulu:

• Kunci API yang dibuat di Developer console. Setiap kunci berawalan or_live_ dan dikirim sebagai token Bearer; dengan batas 10 per akun, runner CI layak mendapat kunci sendiri.
• Endpoint webhook dengan rahasianya disimpan di sisi server, jika Anda lebih suka dipanggil daripada melakukan polling. Satu akun boleh memiliki lima endpoint.
• Id yang tepat. Estonia adalah ee di setiap permintaan, dan id layanan berasal dari GET /api/v1/services.
• Pengecekan harga langsung. Panggil GET /api/v1/prices?country=ee&service=<id> agar pekerjaan tahu biayanya sebelum menggunakan dana dompet.
• Sandbox, jika Anda masih merangkai integrasi. Atas permintaan, akun pengembangan dapat beralih ke mode sandbox, yang mengembalikan nomor dan kode simulasi secara menyeluruh tanpa menyentuh saldo Anda.
• Anggaran laju permintaan. API menerima 300 permintaan per menit per akun, yang lebih dari cukup kecuali rangkaian uji melakukan polling sembarangan.

Panduan integrasi API OTP membahas masing-masing hal ini lebih dalam.

Bagaimana menjalankan permintaan API OTP Estonia dari awal sampai akhir?

Setelah daftar periksa selesai, urutan panggilannya singkat:

1. POST /api/v1/activations dengan isi {"service": "<id>", "country": "ee"}. Responsnya membawa id aktivasi dan nomor +372 yang diketik ke formulir pendaftaran atau login yang diuji.
2. Picu SMS verifikasi dari aplikasi yang sedang Anda uji.
3. Tunggu kodenya. Endpoint Anda menerima activation.sms_received, atau Anda memanggil GET /api/v1/activations/{id} dengan interval yang wajar.
4. Kirim kode di aplikasi dan catat hasilnya terhadap id aktivasi.
5. Jika jalur uji berubah dan nomor tidak lagi diperlukan, panggil POST /api/v1/activations/{id}/cancel agar dana yang ditahan langsung dilepaskan.

Untuk pengiriman webhook, baca header X-OTPRoute-Signature (t=<unix>,v1=<hex>), hitung HMAC-SHA256 atas <t>.<raw body> dengan rahasia endpoint, bandingkan dalam waktu konstan, dan buang apa pun dengan timestamp lama. Mengamankan webhook OTP dengan HMAC memandu Anda lewat handler acuan. Buat penulisan data bersifat idempoten pada id aktivasi, karena percobaan ulang bisa mengirim peristiwa yang sama dua kali.

Layanan apa saja yang bisa mengirim kode ke nomor verifikasi Estonia?

Snapshot langsung untuk Estonia mencatat lebih dari 1,700 layanan. Rute populer meliputi WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb, dan ChatGPT (OpenAI).

Stok bergerak sepanjang hari, sehingga rute yang menjawab pagi ini bisa menipis di malam hari. Anggap GET /api/v1/countries dan endpoint harga sebagai sumber kebenaran, jangan menanam daftar secara permanen di fixture pengujian Anda.

Bagaimana nomor +372 sebaiknya disimpan dan divalidasi?

Estonia termasuk rencana penomoran yang paling sederhana, dan justru karena itulah validator yang malas sering gagal di sini. Tidak ada prefiks trunk yang harus dibuang: nomor yang ditulis secara domestik adalah digit yang sama yang Anda tambahkan setelah +372. Nomor seluler biasanya diawali 5 dan panjangnya tujuh atau delapan digit, sehingga regex yang memaksa panjang nasional tetap akan menolak input yang valid.

Aturan praktis untuk formulir dan basis data Anda:

• Simpan string E.164 lengkap, seperti +3725xxxxxxx, dan simpan input mentah pengguna secara terpisah jika diperlukan untuk dukungan.
• Jangan pernah menambahkan nol di depan; tidak ada yang perlu dibuang atau ditambahkan.
• Uji panjang seluler tujuh digit maupun delapan digit pada input mask Anda.

Teks verifikasi untuk pengguna Estonia biasanya tiba dalam bahasa Estonia, meski banyak aplikasi mengikuti bahasa akun atau perangkat, dan template berbahasa Rusia atau Inggris juga umum. Jika produk Anda menyediakan lokal Estonia, pastikan huruf seperti õ, ä, ö, dan ü tetap utuh dari template hingga ke ponsel.

Mengapa tim menguji alur pendaftaran pada nomor Estonia?

Estonia punya pengaruh yang melampaui ukurannya bagi tim perangkat lunak. Reputasi pemerintahan digitalnya dan program e-Residency membuat banyak pendiri dan perusahaan jarak jauh punya kaitan dengan negara ini meski stafnya tinggal di tempat lain, dan produk yang menyasar kawasan Baltik dan Nordik sering meluncur di sana lebih dulu.

Alasan umum seorang pemimpin QA meminta nomor +372 untuk pengujian:

• Memastikan pemilih negara, mask nomor telepon, dan template SMS berperilaku baik untuk pasar UE dengan rencana penomoran pendek.
• Pemeriksaan lokalisasi pada teks berbahasa Estonia sebelum rilis regional.
• Mereproduksi tiket dukungan dari pelanggan Estonia yang kodenya tidak pernah sampai.

Lihat pengujian QA untuk cara tim memasukkan pemeriksaan ini ke dalam siklus rilis.

Apa yang harus diperiksa saat kode tidak kunjung muncul?

Telusuri masalahnya secara berurutan, jangan memesan nomor demi nomor:

1. Biarkan jendela berjalan. Aktivasi terbuka selama 20 menit, dan beberapa layanan mengantre teksnya.
2. Pastikan layanan menerima nomor virtual. Sebagian layanan menolaknya berdasarkan kebijakan; itulah alasan adanya pengembalian dana.
3. Lihat status akhir. Peristiwa activation.expired, atau status kedaluwarsa dari panggilan GET, berarti tidak ada SMS yang tiba dan uangnya sudah kembali ke dompet.
4. Coba ulang dengan sabar. Coba lagi sedikit nanti, atau coba rute lain untuk layanan yang sama, alih-alih memesan ulang dalam putaran cepat.
5. Periksa pemicu Anda sendiri. Uji yang sebenarnya tidak pernah meminta SMS terlihat sama persis dengan kode yang hilang.

Tulisan kami tentang mengurangi kegagalan pengiriman OTP mencantumkan penyebab lain yang layak disingkirkan.

Bisakah saya mempertahankan nomor Estonia jangka panjang, dan bagaimana penagihannya?

Tidak ada nomor Estonia jangka panjang melalui layanan mandiri. Nomor Khusus (Dedicated Numbers) adalah produk AS dan Kanada mulai $1.95/month; untuk Estonia, kirim email ke [email protected] jika tim Anda memerlukan jalur permanen, dan tim akan memberi tahu apa yang diizinkan aturan setempat, tanpa janji ketersediaan.

Penagihan untuk routing OTP berjalan lewat satu dompet USD prabayar tanpa biaya bulanan dan tanpa paket yang harus dipilih. Isi saldo dengan kartu atau USDT atau USDC, dan setiap pengisian saldo menghasilkan faktur PDF lewat email. Tarif terkini ada di halaman harga, dan referensi endpoint ada di dokumentasi.

Pertanyaan umum

Bisakah saya menguji alur pendaftaran Estonia di aplikasi saya tanpa SIM lokal?

Bisa. Pesan nomor +372 lewat OTP Gateway, pakai di formulir pendaftaran Anda, dan baca kodenya dari dasbor, webhook, atau endpoint aktivasi.

Apa id negara Estonia di API OTP Route?

Gunakan ee sebagai nilai country pada permintaan aktivasi dan harga.

Apakah nomor telepon Estonia punya prefiks trunk yang harus dibuang?

Tidak. Estonia tidak punya prefiks trunk, sehingga digit domestik mengikuti +372 tanpa perubahan.

Apakah saya ditagih saat kode Estonia tidak tiba?

Tidak. Jika tidak ada yang tiba dalam jendela 20 menit, atau Anda membatalkan lebih dulu, seluruh jumlahnya kembali ke dompet Anda secara otomatis.

Bisakah non-developer memesan nomor verifikasi Estonia?

Bisa. Di dasbor, pilih Estonia dan layanannya, konfirmasi harga yang ditampilkan, salin nomornya ke aplikasi, lalu tunggu kode muncul di layar yang sama.

Bisakah integrasi Estonia dilatih dulu sebelum dana sungguhan terpakai?

Minta dukungan untuk mengalihkan akun pengembangan Anda ke sandbox, yang mengembalikan nomor dan kode simulasi sehingga seluruh alur dapat berjalan tanpa dana dompet.

Aturan apa yang berlaku untuk cara saya memakai nomor ini?

Patuhi ketentuan setiap layanan dan Kebijakan Penggunaan yang Dapat Diterima (Acceptable Use Policy) OTP Route; nomor ini untuk menguji dan mengoperasikan produk serta akun Anda sendiri yang sah.

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.