API verifikasi SMS Nigeria (+234) untuk tim QA, fintech, dan peluncuran produk

Endpoint mana yang dipanggil untuk menerima OTP Nigeria?

Semuanya berada di bawah https://otproute.com/api/v1 dan diautentikasi dengan Bearer key yang diawali or_live_. ID negara Nigeria adalah ng. Integrasi yang umum terdiri dari empat panggilan:

1. GET /api/v1/prices?country=ng&service=<id> untuk memastikan harga terkini sebelum memesan.
2. POST /api/v1/activations dengan {"service": "<id>", "country": "ng"} untuk memesan nomor +234. Simpan activation id yang dikembalikan; setiap panggilan dan event webhook berikutnya menggunakan id itu sebagai kunci.
3. GET /api/v1/activations/{id} untuk membaca status dan, setelah terkirim, kodenya.
4. POST /api/v1/activations/{id}/cancel jika pengujian Anda gagal di tengah jalan dan nomor tidak diperlukan lagi.

GET /api/v1/balance berguna sebagai pemeriksaan awal di CI agar rangkaian tes malam hari langsung gagal ketika saldo dompet menipis. Panduan integrasi API OTP membahas urutan yang sama lengkap dengan penanganan error.

Apakah rangkaian tes di Lagos sebaiknya memakai polling atau webhook?

Polling cukup untuk beberapa kali uji manual. Begitu pipeline memesan beberapa nomor +234 secara paralel, webhook lebih rapi. Daftarkan salah satu dari lima endpoint Anda di Developer console lalu berlangganan activation.sms_received, activation.expired, dan activation.cancelled.

Setiap request membawa X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hitung ulang HMAC-SHA256 atas timestamp, sebuah titik, dan raw body menggunakan secret endpoint Anda, bandingkan dalam waktu konstan, lalu tolak request jika timestamp-nya sudah lama. Simpan activation id yang sudah diproses agar event yang dikirim ulang tidak memicu tes Anda dua kali. Artikel tentang mengamankan webhook OTP dengan HMAC memuat daftar periksa yang lebih lengkap. Jaga total lalu lintas di bawah 300 request per menit per akun, batas yang longgar jika Anda mengandalkan event dan bukan polling yang rapat.

Layanan apa saja yang tersedia di rute +234?

Rute ng saat ini mencantumkan lebih dari 2.700 layanan. Yang sering diminta antara lain WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon, dan ChatGPT (OpenAI). Inventaris berubah sepanjang hari seiring mitra operator kami memperbarui pasokan, jadi cek ketersediaan langsung lewat API dan jangan berasumsi layanan yang terlihat kemarin masih ada.

Mengapa tim memerlukan nomor verifikasi Nigeria?

Nigeria adalah salah satu pasar fintech dan aplikasi konsumen tersibuk di Afrika, dan banyak produk menjadikan nomor telepon sebagai identitas utama. Karena itu langkah SMS menjadi bagian penting dalam onboarding dompet digital, aplikasi pinjaman, ride-hailing, pengiriman, dan produk sosial. Tim di luar negeri menggunakan nomor +234 untuk pengujian guna memastikan alur pendaftaran, timer kirim ulang, dan teks error berperilaku seperti yang dialami pengguna lokal.

Bahasa Inggris adalah bahasa resmi, sehingga SMS verifikasi biasanya tiba dalam bahasa Inggris, yang membuat logika assertion pada tes otomatis tetap sederhana. Tim fintech sebaiknya melihat halaman onboarding fintech untuk memahami posisinya di samping pemeriksaan identitas yang tidak digantikan oleh OTP Route.

Bagaimana format nomor ponsel Nigeria?

Kode negaranya +234 dan awalan trunk-nya 0. Orang Nigeria biasanya menulis nomor ponsel sebagai sebelas digit yang diawali nol, misalnya 0803 123 4567; dalam format internasional nol itu hilang sehingga menjadi +234 803 123 4567. Simpan nilai E.164 (+234803...), terima format lokal sebelas digit saat input, dan hapus 0 di depan sebelum menyimpan. Validator yang hanya memeriksa panjang total akan dengan senang hati menerima +2340803..., yang merupakan penyebab umum kegagalan pengiriman di produksi.

Bisakah saya memesan nomor Nigeria dari dashboard saja?

Bisa. Daftar dengan kode email atau Google, isi dompet, buka OTP Gateway, pilih Nigeria dan layanannya, lalu konfirmasi harga yang ditampilkan. Nomor langsung siap dan kodenya muncul di samping pesanan begitu masuk.

Jika kode tidak datang, biarkan jendela 20 menit berjalan sampai habis; Anda hanya membayar jika kode tiba, dan pesanan yang kedaluwarsa atau dibatalkan dikembalikan otomatis. Setelah itu coba pesanan baru sedikit lebih lambat, coba rute lain seperti Ghana bila pengujian Anda memungkinkan, dan periksa apakah layanan tersebut menolak nomor virtual. Hindari memesan berulang kali dalam loop yang rapat.

Bagaimana dengan nomor Nigeria jangka panjang, penagihan, dan sandbox?

OTP Route tidak menyediakan nomor Nigeria jangka panjang secara self-serve. Dedicated Numbers hanya dijual untuk Amerika Serikat dan Kanada, mulai dari $1.95/month. Untuk jalur +234 yang bertahan lama, kirim email ke [email protected]; apakah bisa disediakan bergantung pada regulasi setempat.

Pengeluaran diambil dari satu dompet USD prabayar tanpa paket atau biaya bulanan. Isi saldo dengan kartu atau USDT/USDC dan terima faktur PDF untuk setiap top-up. Minta dukungan untuk mengalihkan akun pengembangan ke mode sandbox, dan integrasi Anda akan menerima nomor serta kode simulasi sehingga Anda dapat menguji seluruh jalur webhook tanpa memakai saldo dompet.

Pertanyaan umum

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

Bisa. Pesan nomor +234 dari OTP Gateway dan baca kodenya di dashboard atau lewat API.

Apa ID negara Nigeria di API OTP Route?

Gunakan ng sebagai nilai country pada pengecekan harga dan permintaan aktivasi.

Berapa biaya menerima OTP SMS Nigeria?

Mulai dari $0.20 per kode, dengan jumlah pasti bergantung pada layanan dan dikembalikan oleh endpoint prices.

Apakah saya membayar jika tidak ada SMS yang masuk?

Tidak. Jika tidak ada yang tiba dalam 20 menit, atau Anda membatalkan, seluruh jumlahnya kembali ke dompet.

Bagaimana sebaiknya menyimpan nomor seperti 0803 123 4567?

Hapus nol di depan dan simpan sebagai +2348031234567, bentuk E.164 tanpa spasi.

Bolehkah nomor ini dipakai untuk akun apa saja?

Hanya untuk produk dan akun sah milik Anda sendiri. Patuhi ketentuan setiap layanan dan Acceptable Use Policy OTP Route; sebagian layanan menolak nomor virtual sama sekali.

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.