Membangun pengujian verifikasi +592 dengan webhook dan polling

Bagaimana merancang alur API OTP Guyana yang mengutamakan webhook?

Untuk apa pun yang lebih dari pemeriksaan sekali jalan, biarkan platform mendorong kode ke Anda alih-alih bertanya berulang-ulang. Di Developer console, tambahkan endpoint HTTPS (satu akun bisa memiliki 5) dan langgankan ke activation.sms_received, bersama activation.expired dan activation.cancelled, agar test runner Anda tahu jalan buntu secepat ia tahu keberhasilan.

Perlakukan setiap request masuk sebagai tidak tepercaya sampai lolos verifikasi:

• Baca header X-OTPRoute-Signature, yang berbentuk t=<unix>,v1=<hex>.
• Gabungkan timestamp, sebuah titik, dan body request apa adanya, lalu hitung HMAC-SHA256 atas string itu dengan secret endpoint.
• Bandingkan digest Anda dengan v1 dalam waktu konstan, dan buang request jika timestamp-nya sudah usang.
• Cari id aktivasi di dalam event; jika sudah pernah diproses, kembalikan sukses dan jangan lakukan apa pun lagi.

Aturan terakhir itu menjaga handler tetap idempoten, sehingga pengiriman ulang setelah gangguan jaringan tidak pernah mengacaukan pengujian. Pembahasan lebih panjang ada di penangkapan OTP berbasis webhook.

Endpoint dan id apa yang dipakai pesanan +592?

Lakukan autentikasi dengan kunci Bearer dari Developer console; kunci live diawali or_live_ dan tiap akun boleh menyimpan hingga 10. Base URL-nya https://otproute.com/api/v1, dan id negara Guyana adalah gy.

Proses yang umum membaca GET /api/v1/prices?country=gy&service=<id> lebih dulu, karena harga dan ketersediaan di rute ini adalah nilai langsung, bukan konstanta. Setelah itu mengirim POST /api/v1/activations dengan {"service": "<id>", "country": "gy"} dan menerima nomor +592 beserta id aktivasi. Tanpa webhook, runner melakukan polling GET /api/v1/activations/{id} setiap beberapa detik, jauh di bawah batas 300 request per menit. Langkah teardown memanggil POST /api/v1/activations/{id}/cancel saat tes dibatalkan, dan panggilan awal GET /api/v1/balance menghentikan rangkaian tes lebih awal jika saldo dompet rendah. Id layanan berasal dari GET /api/v1/services; pusat developer memiliki contoh klien untuk SMS verification API ini.

Bagaimana format nomor +592 untuk penyimpanan?

Guyana memakai kode negara 592 dan nomor nasional tujuh digit tanpa awalan trunk yang perlu dibuang, jadi bentuk E.164-nya cukup +592 diikuti tujuh digit itu. Orang biasanya menulis digitnya sebagai satu kelompok tiga dan satu kelompok empat.

Karena tidak ada angka nol di depan yang dihapus, normalisasi cukup menghapus spasi dan tanda hubung serta menambahkan kode negara ketika pengguna hanya mengetik digit lokal. Bug yang sering muncul adalah formulir yang mengira setiap nomor Amerika Selatan memiliki kode area, atau menetapkan panjang minimum di atas tujuh digit, sehingga menolak input Guyana yang valid. Nomor +592 untuk pengujian akan mengungkapkannya dengan cepat. Simpan string E.164 dan terapkan format lokal hanya saat ditampilkan.

Layanan apa yang bisa menerima kode SMS OTP Guyana, dan bisakah saya memesan manual?

Rute Guyana mencantumkan lebih dari 900 layanan. Yang sering diminta antara lain WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix, dan Claude. Daftar itu hanyalah snapshot dari katalog langsung, jadi pastikan lewat API atau dasbor sebelum merencanakan tes yang bergantung pada satu pengirim tertentu.

Bagi rekan yang tidak menulis kode, dasbor melakukan pekerjaan yang sama. Masuk, buka OTP Gateway, pilih Guyana dan satu layanan, tinjau harganya, lalu pesan. Nomor verifikasi Guyana muncul bersama hitung mundur 20 menit, dan kode ditampilkan di sebelahnya saat tiba.

Apa yang harus dilakukan tes ketika kode +592 terlambat atau tidak datang?

Aktivasi tetap terbuka selama 20 menit. Anda hanya membayar jika kode tiba di dalam jendela itu; jika kedaluwarsa atau Anda membatalkan, seluruh jumlahnya kembali ke dompet tanpa tiket dukungan.

Penanganan yang masuk akal dalam proses otomatis:

1. Tunggu sampai jendela habis sebelum menyatakan gagal, kecuali tes Anda memiliki batas waktu ketat, dalam hal ini batalkan secara eksplisit.
2. Coba lagi nanti, atau pindah ke rute layanan lain jika API menyediakannya.
3. Periksa apakah layanan target menerima nomor virtual; sebagian menolaknya, dan pengembalian dana mencakup tepat kasus itu.
4. Beri jarak antar percobaan dengan backoff alih-alih memesan ulang dalam loop cepat.

Panduan tentang routing negara untuk OTP menjelaskan cara memilih rute cadangan.

Mengapa tim menguji alur pendaftaran Guyana?

Guyana adalah satu-satunya negara Amerika Selatan yang berbahasa resmi Inggris, dan Georgetown menjadi tuan rumah Sekretariat CARICOM, sehingga negara ini sering muncul dalam peluncuran yang memperlakukan Komunitas Karibia sebagai satu pasar. Sektor energi lepas pantai yang tumbuh pesat telah menarik kontraktor dan pemasok internasional, sementara diaspora besar di Amerika Serikat, Kanada, dan Inggris menjaga aplikasi remitansi, pesan, dan perjalanan tetap sibuk dengan nomor +592. Kreol Guyana banyak dituturkan sehari-hari, tetapi teks verifikasi umumnya datang dalam bahasa Inggris. Bagi QA, itu mengarahkan upaya ke input nomor, pemilih negara, dan redaksi persetujuan SMS, bukan ke salinan terjemahan. Lakukan setiap pemeriksaan pada akun milik organisasi Anda, patuhi ketentuan tiap layanan, dan ingat bahwa Acceptable Use Policy OTP Route berlaku untuk semua pesanan.

Bisakah saya mempertahankan saluran Guyana, dan bagaimana pemakaian ditagih?

Nomor jangka panjang swalayan tidak ditawarkan untuk Guyana. Dedicated Number OTP Route hanya mencakup Amerika Serikat dan Kanada, mulai dari $1.95/month. Untuk saluran +592, kirim email ke [email protected] dan tim akan memeriksa apa yang diizinkan aturan setempat, tanpa janji apa pun.

Pembayaran berjalan lewat satu dompet USD prabayar: tanpa biaya bulanan, tanpa paket, top-up dengan kartu atau USDT/USDC, dan invoice PDF lewat email untuk setiap top-up. Akun pengembangan dapat dialihkan ke sandbox atas permintaan, sehingga tes integrasi berjalan dengan nomor dan kode simulasi dan saldo tidak tersentuh. Tarif per layanan tampil di halaman harga.

Pertanyaan umum

Bisakah saya memeriksa pendaftaran Guyana di aplikasi saya tanpa SIM dari operator Guyana?

Bisa. Pesan nomor +592 dari OTP Gateway untuk layanan Anda, masukkan di alur Anda, dan kodenya muncul di dasbor atau sampai ke webhook Anda. Harga mulai dari $0.20 per code.

Id negara apa yang dipakai API untuk Guyana?

Yaitu gy, dipakai baik di query harga maupun di body request aktivasi.

Apakah saya perlu membuang angka nol di depan pada nomor Guyana?

Tidak. Guyana tidak memiliki awalan trunk, jadi bentuk E.164-nya adalah +592 diikuti nomor tujuh digit.

Dalam bahasa apa pesan verifikasi +592 datang?

Biasanya bahasa Inggris, bahasa resminya. Namun pengirimlah yang menentukan redaksinya, dan bisa mengikuti pengaturan bahasa aplikasi.

Apakah ada pengembalian dana jika layanan tidak pernah mengirim SMS?

Ada, dan otomatis. Jika 20 menit berlalu tanpa kode, atau Anda membatalkan, seluruh jumlahnya kembali ke dompet Anda.

Bisakah saya menguji seluruh integrasi tanpa mengeluarkan uang?

Minta dukungan untuk mengalihkan akun pengembangan Anda ke sandbox. Sandbox mengembalikan nomor dan kode simulasi, sehingga panggilan API dan webhook dapat diuji dari ujung ke ujung.

Apakah tersedia nomor +592 jangka panjang?

Tidak sebagai produk swalayan. Dedicated Number hanya dijual di Amerika Serikat dan Kanada; kirim email ke [email protected] untuk menanyakan soal Guyana.

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.