Kode verifikasi SMS Jamaika: daftar periksa, langkah, dan solusi

Apa yang perlu dipastikan sebelum aktivasi Jamaika pertama?

Jamaika berada di dalam Rencana Penomoran Amerika Utara, sehingga beberapa pemeriksaan berbeda dari kebanyakan negara:

• Validator Anda menerima nomor +1 yang bukan milik AS atau Kanada. Banyak formulir pendaftaran diam-diam mengasumsikan semua nomor +1 adalah Amerika.
• Pemilih negara Anda mencantumkan Jamaika secara terpisah, bukan memperlakukan +1 sebagai satu wilayah.
• Kunci API or_live_ sudah ada di Developer console, dan endpoint webhook beserta secret-nya sudah dipasang, atau harness tes Anda diatur untuk polling.
• Dompet sudah terisi, atau mode sandbox sudah diaktifkan untuk uji coba.
• Anda tahu ID layanan dari GET /api/v1/services; ID negara Jamaika adalah jm.

Kesalahan pada dua poin pertama menghasilkan kegagalan yang tampak seperti masalah routing padahal sepenuhnya ada di kode Anda sendiri.

Mengapa nomor Jamaika +1 perlu penanganan khusus?

Nomor Jamaika memakai kode area 876 dan 658 yang lebih baru, diikuti nomor pelanggan tujuh digit, sehingga bentuk E.164 lengkapnya adalah +1 ditambah sepuluh digit. Secara domestik orang menekan angka 1 di depan untuk jarak jauh, yang harus dibuang sebelum disimpan.

Hal penting bagi engineer adalah bahwa +1 saja tidak memberi tahu apa pun tentang negaranya. Deteksi wilayah harus melihat kode area, dan logika apa pun yang memilih mata uang, zona waktu, atau templat SMS dari kode panggilan memerlukan kehati-hatian yang sama. Simpan string E.164 kanonis, simpan wilayah yang terdeteksi di kolom terpisah, dan uji masukan 876 maupun 658.

Bahasa Inggris adalah bahasa resmi dan teks verifikasi hampir selalu datang dalam bahasa Inggris, sementara percakapan sehari-hari sering memakai Patois Jamaika. Tim melakukan pengujian di sini untuk peluncuran di Karibia, untuk alur remitansi dan fintech yang melayani diaspora di AS, Inggris, dan Kanada, serta untuk produk pariwisata dan perhotelan. Artikel routing negara untuk OTP membahas cara memilih rute per pasar.

Apa saja langkah dalam API verifikasi SMS Jamaika?

1. Periksa harga langsung dengan GET /api/v1/prices?country=jm&service=<id> pada base URL https://otproute.com/api/v1.
2. Pesan: POST /api/v1/activations dengan isi {"service": "<id>", "country": "jm"}. Catat ID aktivasi dan nomornya.
3. Masukkan nomor itu ke aplikasi yang Anda uji.
4. Terima kode lewat event activation.sms_received pada webhook Anda, atau dengan polling GET /api/v1/activations/{id}.
5. Hentikan percobaan Jamaika lebih awal dengan mengirim POST /api/v1/activations/{id}/cancel, yang melepaskan penahanan dana.

Sebelum bertindak atas event apa pun, hitung ulang HMAC-SHA256 dari "<t>.<raw body>" dengan secret endpoint Anda, bandingkan dengan nilai v1 di X-OTPRoute-Signature, dan tolak timestamp yang terlalu lama. Tangani juga activation.expired dan activation.cancelled, dengan kunci ID aktivasi, agar percobaan ulang tidak pernah diproses dua kali. Untuk perencanaan kapasitas, satu akun dapat memegang 10 kunci dan 5 endpoint webhook, dengan batas 300 permintaan per menit untuk semuanya.

Aplikasi apa saja yang bisa menerima kode di rute Jamaika?

Jamaika saat ini mencantumkan lebih dari 900 layanan. Yang sering dipakai mencakup WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb, dan ChatGPT (OpenAI).

Ketersediaan per layanan bergerak sepanjang hari, jadi baca endpoint harga di awal setiap eksekusi, jangan menuliskan daftar secara permanen di kode.

Bagaimana non-developer mengikuti daftar periksa yang sama di dasbor?

Buat akun di /signup dengan kode email atau Google, aktifkan TOTP, lalu isi saldo. Kemudian buka OTP Gateway, pilih layanan, pilih Jamaika, dan konfirmasi harga langsung. Tempel nomor ke aplikasi, dan kode muncul di dasbor begitu pesan tiba. Staf dukungan sering memakai jalur ini untuk mereproduksi masalah pendaftaran pelanggan pada nomor Jamaika.

Pemecahan masalah: kode Jamaika terlambat, hilang, atau ditolak

• Ditolak saat dimasukkan? Periksa formulir Anda sendiri lebih dulu; validator khusus AS sering menjadi penyebabnya. Jika aplikasi pihak ketiga itu sendiri menolak nomornya, mungkin ia tidak menerima nomor virtual.
• Belum ada apa-apa? Biarkan aktivasi terbuka selama 20 menitnya, jangan membatalkan dan memesan ulang.
• Masih belum ada? Coba lagi nanti atau dengan rute layanan yang berbeda. Hindari membanjiri pesanan yang sama dalam putaran.

Ketika tidak ada SMS yang sampai ke nomor sebelum jendela berakhir, seluruh biaya dikembalikan ke dompet secara otomatis. Panduan mengurangi kegagalan pengiriman OTP memuat daftar periksa yang lebih panjang.

Apakah saluran khusus, dompet, dan sandbox berlaku untuk Jamaika?

Berbagi kode +1 tidak menjadikan Jamaika bagian dari produk saluran khusus. Dedicated Virtual Number hanya dijual untuk Amerika Serikat dan Kanada, mulai $1.95/bulan, dan tidak ada nomor Jamaika jangka panjang swalayan. Jika Anda membutuhkannya, kirim email ke [email protected] untuk bertanya; aturan setempat yang menentukan dan tidak ada yang dijanjikan.

Selebihnya bekerja sama seperti di mana pun: dompet USD prabayar, tanpa biaya bulanan, top-up lewat kartu atau USDT/USDC, dan faktur PDF lewat email untuk masing-masing. Mode sandbox, tersedia atas permintaan, mengembalikan nomor dan kode simulasi untuk tes integrasi. Lihat /pricing untuk cara kerja biayanya.

Pertanyaan umum

Bisakah saya menguji verifikasi telepon Jamaika di aplikasi saya tanpa berada di Kingston?

Bisa. Pesan nomor +1 876 atau +1 658 untuk layanan Anda lewat OTP Route dan baca kodenya di dasbor atau API, di mana pun tim Anda berada.

ID negara apa yang saya kirim untuk Jamaika?

Kirim jm. Kode panggilannya +1, tetapi API mengenali negara lewat ID tersebut.

Apakah nomor Jamaika dianggap nomor AS?

Tidak. Nomor itu berbagi kode +1, tetapi merupakan negara terpisah dengan kode area sendiri, dan banyak aplikasi memperlakukannya sebagai Jamaika.

Bagaimana nasib uang saya jika kode Jamaika tidak datang?

Jika tidak ada SMS dalam 20 menit, atau Anda membatalkan, seluruh jumlah kembali ke dompet.

Bisakah saya membeli nomor Jamaika jangka panjang dari OTP Route?

Tidak secara swalayan. Dedicated Number jangka panjang hanya mencakup AS dan Kanada; kirim email ke tim dukungan untuk menanyakan Jamaika.

Adakah cara menguji alur webhook tanpa membayar?

Minta mode sandbox pada akun pengembangan. Mode ini mengembalikan nomor dan kode simulasi, dan artikel penangkapan OTP berbasis webhook menjelaskan sisi handler-nya.

Penggunaan nomor +1 Jamaika apa yang diperbolehkan untuk pengujian?

Menguji produk Anda sendiri, otomatisasi QA, dan menjalankan akun bisnis yang sah. Rute Karibia ini terikat pada ketentuan setiap aplikasi serta Kebijakan Penggunaan yang Dapat Diterima OTP Route.

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.