Mengalirkan kode verifikasi Republik Kongo (+242) ke tumpukan pengujian Anda

Panggilan API apa yang mengambil kode +242 dari awal sampai akhir?

Semuanya berada di bawah https://otproute.com/api/v1 dan diautentikasi dengan kunci Bearer berawalan or_live_. Buat kunci di konsol Developer; satu akun dapat memegang hingga 10, sehingga mudah memberi staging, CI, dan laptop rekan tim kredensial terpisah yang bisa dicabut sendiri-sendiri.

Satu putaran pengujian pasar Brazzaville yang umum berjalan seperti ini:

1. Tarik GET /api/v1/services dan GET /api/v1/countries, lalu simpan idnya di cache. Republik Kongo adalah cg (jangan tertukar dengan tetangganya yang lebih besar, yang punya id dan halaman sendiri di Kongo (DRC)).
2. Minta GET /api/v1/prices?country=cg&service=<id> untuk harga langsung dan ketersediaan aplikasi yang Anda uji.
3. Buat aktivasi dengan POST /api/v1/activations dan isi seperti {"service": "telegram", "country": "cg"}. Anda menerima id aktivasi beserta nomor +242.
4. Ketik nomor itu ke layar pendaftaran atau login produk Anda sendiri.
5. Ambil kode Kongo dari pengiriman webhook atau dengan polling GET /api/v1/activations/{id}. Jika pengujian dibatalkan, lepaskan dengan POST /api/v1/activations/{id}/cancel.

Jalankan GET /api/v1/balance sebelum rangkaian pengujian dimulai agar dompet kosong membuat job gagal lebih awal, bukan di tengah jalan. Batas 300 permintaan per menit menyisakan ruang yang cukup untuk beberapa pekerja paralel. Bentuk permintaan dan respons lengkap ada di dokumentasi developer.

Bagaimana cara memasang webhook bertanda tangan untuk aktivasi Kongo?

Polling cukup untuk satu insinyur yang mengeklik sebuah alur; webhook lebih ramah bagi armada CI. Tambahkan endpoint di konsol Developer (lima diizinkan per akun) dan berlangganan activation.sms_received, activation.expired, serta activation.cancelled.

Setiap permintaan membawa X-OTPRoute-Signature: t=<unix>,v1=<hex>. Susun ulang HMAC-SHA256 dari "<t>.<raw body>" memakai secret endpoint itu, bandingkan dengan v1 lewat pemeriksaan waktu konstan, dan buang apa pun yang timestamp-nya sudah lama. Hash byte mentah sebelum penguraian JSON apa pun, karena JSON yang diserialisasi ulang jarang cocok byte demi byte.

Perlakukan event sebagai terkait pada id aktivasi. Jika event yang sama datang dua kali, handler Anda harus menyadari bahwa id itu sudah selesai dan cukup mengembalikan status sukses. Panduan penangkapan webhook menjelaskan pola antrean yang menjaga pelaksana pengujian yang lambat dari timeout.

Layanan apa saja yang dapat dicakup nomor verifikasi Kongo?

Snapshot hari ini untuk cg mencakup WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber, dan imo. Secara keseluruhan negara ini memiliki lebih dari 1.000 layanan di OTP Gateway.

Daftar itu bergeser sepanjang hari saat rute dibuka dan ditutup, jadi jangan pernah menanamnya secara permanen. Biarkan harness pengujian Anda menanyakan endpoint harga untuk layanan spesifik yang dibutuhkan, dan lewati atau jadwalkan ulang dengan baik ketika ketersediaan kosong. Aplikasi pesan cenderung mendominasi barisan layanan Kongo, sesuai dengan cara banyak pelanggan di sana pertama kali bertemu produk baru: lewat tautan yang dibagikan di grup obrolan, bukan pencarian di toko aplikasi.

Bagaimana nomor +242 harus disimpan dan dinormalisasi?

Nomor Republik Kongo terdiri dari sembilan digit setelah kode negara, dan tidak seperti banyak rencana penomoran, angka 0 di depan adalah bagian dari nomor pelanggan, bukan awalan trunk. Nomor seluler biasa ditulis 06… atau 05… secara lokal dan +242 06… secara internasional. Normalizer yang disalin dari basis kode Eropa dan membuang angka nol di depan akan merusak nomor ini secara diam-diam, jadi simpan persis string E.164 yang diberikan API dan validasi panjang per negara, bukan dengan satu aturan global.

Bahasa Prancis adalah bahasa resmi dan bahasa yang biasa dipakai SMS verifikasi, meski Lingala dan Kituba banyak dituturkan sehari-hari. Harapkan karakter beraksen di beberapa templat dan pastikan parser Anda mengambil digit dengan pola, bukan mengandalkan kata bahasa Inggris yang tetap.

Tim biasanya menguji di sini saat meluncurkan produk ke Afrika Tengah berbahasa Prancis, mendukung staf operasional di Brazzaville atau Pointe-Noire, atau melayani pelanggan Kongo di luar negeri yang masih mendaftar dengan nomor asal. Memeriksa seluruh alur pada rute +242 yang nyata menangkap masalah format dan teks yang akan terlewat oleh simulator.

Bagaimana jika tidak ada kode yang sampai ke nomor +242?

Keheningan biasanya masalah rute atau penerimaan, bukan bug integrasi. Panduan yang masuk akal:

• Biarkan jendela 20 menit berjalan sampai selesai sebelum menyimpulkan apa pun; sebagian pengirim mengumpulkan lalu lintas keluarnya.
• Pastikan layanan target menerima nomor virtual. Beberapa tidak, dan itulah tepatnya mengapa kode yang tidak diterima tidak dikenai biaya.
• Coba lagi nanti, atau beralih ke rute layanan lain, jangan menembakkan pesanan baru dalam putaran cepat yang menghabiskan batas laju.
• Batalkan nomor yang tidak lagi dibutuhkan agar dana langsung kembali, bukan menunggu kedaluwarsa.

Artikel kami tentang mengurangi kegagalan pengiriman OTP membahas backoff dan anggaran percobaan ulang lebih dalam.

Bisakah saya menyimpan nomor Kongo jangka panjang?

Tidak ada nomor jangka panjang mandiri untuk Republik Kongo. OTP Gateway menerbitkan satu nomor per kode verifikasi, dan itulah satu-satunya produk yang ditawarkan untuk cg saat ini.

Dedicated Virtual Numbers OTP Route adalah produk Amerika Serikat dan Kanada mulai $1.95/month, dengan SMS masuk dan keluar serta panggilan lewat browser. Jika tim Anda sungguh membutuhkan saluran Kongo yang menetap, kirim email ke [email protected]; apakah sesuatu bisa diatur bergantung pada aturan setempat, jadi anggap itu pertanyaan, bukan janji. Pertimbangannya diringkas di nomor sementara vs nomor khusus.

Bagaimana penagihan dan pengujian aman untuk penyiapan perutean OTP Kongo?

Penagihan berjalan dari satu dompet USD prabayar tanpa langganan atau tingkatan paket. Isi saldo dengan kartu atau stablecoin USDT/USDC, dan setiap isi ulang menghasilkan faktur PDF lewat email untuk tim keuangan Anda.

Sebelum menyambungkan uang sungguhan ke sebuah pipeline, minta dukungan mengalihkan akun pengembangan ke mode sandbox. Mode ini mengembalikan nomor dan kode simulasi, sehingga Anda dapat menjalankan seluruh jalur API verifikasi SMS dari ujung ke ujung tanpa mengeluarkan apa pun. Gunakan OTP Route hanya pada produk Anda sendiri dan akun yang berhak Anda kelola; ketentuan setiap layanan dan Kebijakan Penggunaan yang Dapat Diterima kami tetap berlaku. Lihat harga untuk cara biaya dan pengembalian dana tampil di dompet.

Pertanyaan umum

Apa id negara untuk Republik Kongo di API OTP Route?

Id-nya cg. Republik Demokratik Kongo adalah negara terpisah dengan id sendiri, jadi periksa kembali mana yang dirujuk konfigurasi Anda.

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

Bisa. Pesan nomor +242 untuk pengujian dari OTP Gateway, masukkan ke aplikasi Anda, lalu baca kodenya di dasbor atau lewat API.

Apakah saya membuang angka nol di depan saat menyimpan nomor +242?

Tidak. Di Republik Kongo angka 0 adalah bagian dari nomor pelanggan sembilan digit, jadi simpan nilai E.164 persis seperti yang dikembalikan API.

Bahasa apa yang dipakai pesan verifikasi Kongo?

Kebanyakan tiba dalam bahasa Prancis, kadang bahasa Inggris untuk aplikasi internasional. Ambil digit dengan pola, jangan mencocokkan kata tertentu.

Apakah saya dikenai biaya jika kode tidak muncul?

Tidak. Jika jendela berakhir tanpa SMS, atau Anda membatalkan lebih dulu, seluruh jumlah kembali ke dompet Anda secara otomatis.

Berapa biaya menerima SMS OTP Kongo?

Mulai $0.20 per kode; harga +242 setiap aplikasi dikutip secara langsung, jadi kueri dulu sebelum memesan.

Apakah ada sandbox untuk membangun integrasi?

Ada, atas permintaan. Dukungan dapat menempatkan akun pengembangan ke mode sandbox, yang mengembalikan nomor dan kode simulasi tanpa menyentuh dana dompet.

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.