API OTP Samoa: Menguji Pendaftaran +685 di Seluruh Pasifik

Samoa sekilas untuk tim produk dan QA

Samoa adalah negara kepulauan merdeka di Pasifik dengan bahasa Samoa dan Inggris sebagai bahasa resmi. Komunitas Samoa yang besar tinggal di Selandia Baru, Australia, dan Amerika Serikat, sehingga aplikasi remitansi, pesan instan, dan perjalanan sering perlu berfungsi bagi pengguna yang berpindah antara negara-negara tersebut dan kampung halaman.

Ada dua hal yang patut diketahui. Pertama, Samoa (+685) adalah negara yang berbeda dari Samoa Amerika, yang berada dalam rencana penomoran Amerika Utara dengan kode +1 684; tertukarnya keduanya di pemilih negara akan membuat kode terkirim ke tempat yang salah. Kedua, Samoa pindah ke sisi barat Garis Tanggal Internasional pada 2011 dan jamnya jauh mendahului UTC, sehingga cocok sebagai kasus uji batas tanggal pada logika kedaluwarsa.

Bagi tim produk, Samoa jarang menjadi pasar peluncuran tersendiri. Negara ini biasanya muncul sebagai bagian dari peluncuran di kawasan Pasifik, sebagai kebutuhan aplikasi yang menyasar diaspora, atau karena organisasi mitra di Apia perlu akun bisnisnya dikonfirmasi. Dalam semua kasus, tugasnya sama: membuktikan bahwa pengguna +685 dapat menyelesaikan alur pendaftaran Anda.

Bagaimana nomor +685 sebaiknya ditangani di kode?

Nomor nasional Samoa pendek dibandingkan sebagian besar pasar, sehingga validator yang disetel untuk nomor sembilan atau sepuluh digit bisa menolak nomor yang sah. Simpan nomor sebagai +685 diikuti digit nasional tanpa pemisah, dan hapus angka nol yang ditambahkan pengguna karena kebiasaan. Karena cap waktu webhook berupa detik Unix, bandingkan dalam UTC, bukan waktu lokal; dengan begitu Anda terhindar dari kejutan saat server Anda dan penguji di Samoa berada pada hari kalender yang berbeda.

Jika produk Anda memungkinkan pengguna berpindah antara nomor Selandia Baru dan nomor Samoa pada profil yang sama, tambahkan pengujian yang mengganti kode negara dan memastikan status verifikasi lama terhapus, agar kode yang dikirim ke satu nomor tidak pernah diterima untuk nomor lainnya.

Layanan apa saja yang tersedia di rute Samoa?

Katalog Samoa saat ini mencantumkan lebih dari 600 layanan. Di antara yang sering diminta adalah WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon, dan Discord. Cakupan di sini lebih tipis daripada pasar besar dan berubah sepanjang hari, jadi periksa GET /api/v1/services dan GET /api/v1/countries sebelum setiap pengujian. Jika sebuah layanan tidak ada, rute tetangga seperti Fiji atau Tonga mungkin cocok untuk pengujian Anda.

Katalog yang lebih ringan adalah alasan bagus untuk membuat harness pengujian Anda toleran: jika layanan pilihan tidak tersedia saat dijalankan, tandai kasusnya sebagai dilewati, bukan gagal, dan catat agar seseorang dapat mencobanya lagi nanti.

Meminta kode Samoa lewat API

Dengan kunci Bearer (or_live_…) ke https://otproute.com/api/v1, cari harga lewat GET /api/v1/prices?country=ws&service=<id>, lalu kirim {"service": "<id>", "country": "ws"} ke POST /api/v1/activations. Lacak id aktivasi dengan polling GET /api/v1/activations/{id} atau dengan mendengarkan activation.sms_received. Verifikasi HMAC X-OTPRoute-Signature pada setiap webhook, tolak cap waktu yang basi, dan buat handler aman dijalankan dua kali untuk aktivasi yang sama. Panduan integrasi menunjukkan bentuk lengkapnya.

Batas laju cukup longgar untuk pasar seukuran ini: setiap akun mendapat hingga 10 kunci, 5 endpoint webhook, dan 300 permintaan per menit. Jika Anda melakukan polling, jeda beberapa detik antar pengecekan sudah lebih dari cukup.

Melakukannya secara manual di dasbor

1. Masuk dan buka OTP Gateway.
2. Pilih layanan, lalu Samoa.
3. Periksa harga langsung dan konfirmasi.
4. Tempel nomor +685 ke aplikasi yang diuji dan minta kodenya.
5. Baca kode di layar, atau batalkan jika tidak lagi diperlukan.

Saat kode +685 lambat atau tidak datang

Biarkan aktivasi tetap terbuka selama 20 menit penuh sebelum menyerah. Sebagian aplikasi menolak nomor virtual sama sekali, dan itulah sebabnya pesanan yang tidak dijawab dikembalikan dananya. Jika sebuah rute tetap sunyi, coba lagi nanti atau pilih rute layanan lain; memesan ulang terus-menerus dalam hitungan detik jarang membantu dan menghabiskan batas laju Anda.

Catat id aktivasi pada setiap percobaan agar Anda bisa melihat apakah kesunyian itu berasal dari satu aplikasi tertentu atau dari rute secara keseluruhan.

Nomor jangka panjang dan pembayaran

OTP Route tidak menjual nomor Samoa jangka panjang secara swalayan. Dedicated Numbers mulai dari $1.95/month dan terbatas di Amerika Serikat dan Kanada; untuk jalur Samoa, hubungi [email protected], tanpa janji bahwa hal itu bisa diatur. Dompet USD prabayar menerima kartu dan USDT/USDC, mengirim faktur PDF untuk setiap isi ulang, dan tanpa biaya bulanan. Minta mode sandbox pada akun pengembangan untuk berlatih alur ws tanpa menghabiskan dana.

Pertanyaan umum

Apakah Samoa sama dengan Samoa Amerika untuk nomor telepon?

Tidak. Samoa memakai +685, sedangkan Samoa Amerika memakai +1 684. Pilih yang tepat di pemilih negara dan di API.

Apa id negara API untuk Samoa?

Gunakan ws pada kueri harga dan pada permintaan aktivasi.

Berapa biaya kode verifikasi Samoa?

Mulai $0.20 per kode; harga pastinya bergantung pada layanan dan ditampilkan sebelum Anda memesan.

Bisakah saya menguji pendaftaran pengguna Samoa dari Selandia Baru atau Australia?

Bisa. Nomor +685 menerima SMS dan OTP Route menampilkannya kepada Anda di mana pun tim Anda bekerja.

Apakah saya membayar jika tidak ada pesan yang tiba?

Tidak. Aktivasi yang kedaluwarsa atau dibatalkan dikembalikan ke dompet secara otomatis.

Dalam bahasa apa kode Samoa dikirim?

Biasanya bahasa Inggris, yang resmi bersama bahasa Samoa. Urai angkanya, bukan teks di sekitarnya.

Bisakah nomor ini dipakai untuk membuka banyak akun?

Tidak. Ikuti ketentuan setiap layanan; Kebijakan Penggunaan yang Dapat Diterima membatasi OTP Route untuk menguji dan mengoperasikan akun serta produk Anda sendiri yang sah.

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.