Menerima Kode Verifikasi +966 secara Terprogram untuk Peluncuran di Arab Saudi

Seperti apa satu aktivasi +966 lewat API?

Kita mulai dari panggilannya, karena kebanyakan pembaca halaman ini sedang menyambungkan API verifikasi SMS ke rangkaian pengujian atau alat internal. Semua endpoint berada di bawah https://otproute.com/api/v1 dan memerlukan kunci Bearer berawalan or_live_, yang dibuat di Developer console.

1. GET /api/v1/countries dan GET /api/v1/services memberi Anda id-nya. Arab Saudi adalah sa.
2. GET /api/v1/prices?country=sa&service=<id> mengembalikan tarif langsung untuk pasangan itu; catat bersama eksekusi pengujian.
3. POST /api/v1/activations dengan {"service": "<id>", "country": "sa"} mengembalikan id aktivasi dan nomor +966.
4. Pengujian Anda memasukkan nomor ke aplikasi, dan kode tiba sebagai event atau lewat GET /api/v1/activations/{id}.
5. Jika pengujian ditinggalkan, POST /api/v1/activations/{id}/cancel melepaskannya dan mengembalikan dana ke dompet.

GET /api/v1/balance berguna sebagai pemeriksaan awal sehingga job malam gagal lebih dini dengan pesan yang jelas, bukan di tengah eksekusi. Batas yang perlu direncanakan: 10 kunci dan 5 endpoint webhook per akun, 300 permintaan per menit.

Bagaimana penerima webhook kami harus memperlakukan event OTP Saudi?

Daftarkan sebuah endpoint dan berlangganan activation.sms_received, activation.expired, dan activation.cancelled. Setiap permintaan menyertakan X-OTPRoute-Signature dalam bentuk t=<unix>,v1=<hex>.

• Susun ulang string yang ditandatangani sebagai <t>.<raw body> dan hitung HMAC-SHA256 dengan secret endpoint tersebut.
• Bandingkan dengan v1 memakai fungsi waktu-konstan, dan tolak apa pun yang cap waktunya terlalu lama.
• Perlakukan setiap event berdasarkan id aktivasi, sehingga pengiriman ulang tidak memperbarui apa pun dua kali.
• Balas dengan 2xx secepatnya dan kerjakan tugas yang lambat di job latar belakang.

Polling tetap menjadi cadangan yang sah untuk runner yang tidak dapat menerima koneksi masuk. Tulisan kami tentang penangkapan OTP berbasis webhook dan mengamankan webhook OTP dengan HMAC membahasnya lebih jauh.

Mengapa tim produk menguji dengan nomor +966?

Arab Saudi adalah salah satu pasar digital terbesar di Teluk, dan tim datang ke halaman ini karena alasan praktis: fintech yang menyiapkan onboarding bagi warga Saudi, marketplace yang menambah penjual Teluk, vendor SaaS yang pelanggannya mensyaratkan pemeriksaan masuk regional, atau tim operasi yang mengelola akun bisnis untuk kantor di Riyadh atau Jeddah. Dalam setiap kasus, seseorang harus membuktikan alur berfungsi dengan nomor verifikasi Saudi yang nyata, dan perutean OTP lewat gateway menghemat pengiriman kartu SIM ke kawasan itu. Halaman onboarding fintech menjelaskan skenario tersebut lebih rinci.

Layanan apa saja yang dapat menerima kode di rute Saudi?

Snapshot langsung untuk Arab Saudi mencakup lebih dari 1.000 layanan. Yang sering dipakai meliputi Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord, dan Netflix. Snapchat dan X memiliki audiens yang sangat besar di Kerajaan, sehingga keduanya lazim ada dalam daftar periksa lokalisasi. Inventaris bergerak sepanjang hari, jadi kueri API saat dijalankan.

Bagaimana memformat nomor +966 dan mengurai pesan berbahasa Arab?

Secara lokal, nomor seluler Saudi ditulis dengan awalan trunk 0, biasanya 05 diikuti delapan digit. Bentuk internasionalnya membuang nol itu: +966 5 dan delapan digit sisanya. Normalkan semuanya ke E.164 pada titik masuk, dan hapus nol jika pengguna mengetiknya setelah kode negara.

Bahasa Arab adalah bahasa resmi, jadi pesan verifikasi bisa tiba dalam bahasa Arab, Inggris, atau keduanya. Bahasa Arab ditulis dari kanan ke kiri, dan sebagian templat mungkin memakai angka Arab-Indik, bukan angka Barat. Parser yang memetakan angka-angka itu ke ASCII sebelum mencocokkan, dan mencatat UTF-8 mentah, terhindar dari satu kelas kegagalan semu yang menjengkelkan.

Adakah jalur dasbor bagi orang yang tidak menulis kode?

Ada. Masuk ke OTP Route, buka OTP Gateway, pilih Arab Saudi dan layanannya, tinjau harga, lalu konfirmasi. Nomor langsung muncul dan kodenya ditampilkan di sampingnya saat tiba. Agen dukungan bisa memakai ini untuk mereproduksi masalah pendaftaran pelanggan dalam beberapa menit.

Bagaimana jika kode tak pernah tiba, dan bagaimana dengan nomor jangka panjang serta penagihan?

Jika tidak ada SMS yang tiba dalam 20 menit, atau Anda membatalkan, seluruh jumlahnya otomatis kembali ke dompet. Biarkan jendela waktu berakhir, coba lagi nanti atau lewat rute layanan lain, pastikan layanan menerima nomor virtual, dan hindari memesan ulang dalam putaran cepat.

Tidak ada nomor Saudi jangka panjang swalayan. Dedicated Virtual Numbers hanya ditawarkan di Amerika Serikat dan Kanada, mulai $1.95/month; untuk jalur +966 jangka panjang, kirim email ke [email protected], dengan mengingat bahwa aturan setempat menentukan apakah hal itu mungkin.

Pendanaan memakai satu dompet USD prabayar, bayar sesuai pemakaian, tanpa biaya bulanan. Pembayaran kartu dan USDT/USDC sama-sama dapat dipakai untuk isi ulang, dan masing-masing menghasilkan faktur PDF yang dikirim lewat email. Akun pengembangan dapat dialihkan ke sandbox atas permintaan untuk nomor dan kode simulasi. Lihat halaman harga untuk tarif terkini.

Pertanyaan umum

Bagaimana cara menerima SMS OTP Saudi lewat API?

Buat aktivasi dengan negara sa dan id layanan Anda, lalu ambil kodenya dari webhook activation.sms_received atau dengan polling aktivasi.

Apakah nomor +966 untuk pengujian ditagih jika kodenya gagal?

Tidak. Kode yang tidak datang berarti seluruh jumlahnya dikembalikan ke dompet saat jendela 20 menit berakhir atau Anda membatalkan.

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

Bisa. OTP Gateway menerbitkan nomor +966 untuk satu kode, yang Anda masukkan di aplikasi dan baca kembali lewat dasbor atau API.

Bagaimana cara menyimpan nomor seluler Saudi yang dimasukkan sebagai 05XXXXXXXX?

Buang nol trunk dan simpan sebagai +966 5 ditambah delapan digit sisanya dalam format E.164.

Bisakah kami mempertahankan nomor Saudi yang sama untuk login berikutnya?

Tidak lewat produk swalayan, karena Dedicated Numbers jangka panjang hanya mencakup AS dan Kanada. Kirim email ke tim jika Anda memerlukan jalur Saudi, tanpa jaminan bahwa hal itu dapat disediakan.

Adakah cara berlatih alur Saudi sebelum melibatkan uang sungguhan?

Ada. Minta mode sandbox pada akun pengembangan untuk menerima nomor dan kode simulasi, termasuk webhook.

Penggunaan apa yang diizinkan OTP Route?

Menguji dan mengoperasikan produk serta akun Anda sendiri yang sah. Ikuti ketentuan setiap layanan; Kebijakan Penggunaan yang Dapat Diterima OTP Route berlaku.

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.