Mengalirkan Kode Verifikasi Argentina (+54) ke Integrasi Anda

Apa saja empat panggilan API di balik aktivasi +54?

Semuanya berada di bawah https://otproute.com/api/v1 dan diautentikasi dengan Bearer key yang diawali or_live_. Key diterbitkan di Developer console; satu akun dapat memiliki hingga 10 key dan mendaftarkan 5 endpoint webhook, dengan batas 300 permintaan per menit.

1. Tanyakan harganya. Panggil GET /api/v1/prices?country=ar&service=<id> agar kode Anda tahu biaya langsungnya sebelum menggunakan dana dompet. Id negara Argentina adalah ar.
2. Pesan. Kirim POST /api/v1/activations dengan body JSON {"service": "whatsapp", "country": "ar"}, ganti dengan id layanan apa pun yang dibutuhkan tes Anda. Respons berisi id aktivasi dan nomor +54 untuk diketik di aplikasi yang diuji.
3. Tunggu. Baca GET /api/v1/activations/{id} dengan interval yang wajar, atau biarkan webhook activation.sms_received memberi tahu bahwa kode sudah masuk.
4. Lepaskan lebih awal bila perlu. POST /api/v1/activations/{id}/cancel mengakhiri aktivasi yang tidak lagi Anda inginkan dan mengembalikan uangnya ke dompet.

Jika ingin melihat id sebelum menuliskannya permanen, GET /api/v1/services dan GET /api/v1/countries mencantumkan apa yang saat ini ditawarkan platform. Materi referensi lengkap ada di dokumentasi.

Bagaimana membuat penerima webhook dapat dipercaya untuk kode Argentina?

Setiap pengiriman menyertakan header X-OTPRoute-Signature berbentuk t=<unix>,v1=<hex>. Susun ulang string "<t>.<raw body>", hitung HMAC-SHA256 atasnya dengan secret endpoint tersebut, lalu bandingkan hasilnya dengan v1 menggunakan fungsi constant-time. Buang setiap permintaan yang timestamp-nya sudah basi, karena tanda tangan lama yang masih valid persis seperti tampilan serangan replay.

Selain activation.sms_received, berlanggananlah ke activation.expired dan activation.cancelled agar test runner tidak pernah menggantung menunggu nomor yang sudah ditutup. Perlakukan setiap event dengan id aktivasi sebagai kuncinya, dan tulis handler Anda sehingga pengiriman kedua dari event yang sama tidak mengubah apa pun. Tulisan tentang menandatangani dan memverifikasi webhook OTP menjelaskan logika perbandingannya lebih dalam.

Aplikasi apa saja yang bisa saya verifikasi dengan nomor Argentina?

Snapshot langsung untuk Argentina mencantumkan lebih dari 2.000 layanan. Yang cenderung dipilih tim produk dan QA Argentina antara lain:

• Pesan instan: WhatsApp, Telegram, Signal, Discord
• Akun dan produktivitas: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Media sosial dan video: Instagram, TikTok
• Perdagangan dan mobilitas: Amazon, Uber, Airbnb, Netflix

Daftar ini berubah sepanjang hari, itulah sebabnya API melaporkan ketersediaan secara langsung, bukan dalam tabel statis. Kueri GET /api/v1/services dengan negara ar dalam pikiran sebelum job CI terjadwal dimulai, dan gagal cepat dengan pesan yang jelas jika layanan target Anda sedang tidak tersedia.

Mengapa nomor seluler Argentina membuat validator telepon bermasalah?

Argentina memiliki salah satu rencana penomoran yang paling tidak lazim di kawasan ini. Secara domestik, orang menulis 0 sebagai awalan trunk sebelum kode area dan, untuk seluler, 15 sebelum digit pelanggan, sehingga ponsel di Buenos Aires bisa tampil sebagai 011 15 diikuti delapan digit. Dalam format internasional E.164 keduanya hilang dan angka 9 disisipkan tepat setelah kode negara: +54 9 11 lalu nomor pelanggan delapan digit.

Perbedaan itu penting bagi siapa pun yang menyimpan nomor telepon. Normalkan semuanya ke E.164 sebelum menyimpan, hapus 0 dan 15 saat input, dan tambahkan 9 untuk nomor seluler. Validator yang hanya memeriksa panjang akan dengan senang hati menerima nilai bergaya telepon rumah +54 11 yang tidak dapat menerima SMS. Gunakan nomor persis seperti yang dikembalikan API, jangan memformat ulang sendiri.

Kode yang dikirim ke nomor Argentina biasanya tiba dalam bahasa Spanyol, sering dengan frasa seperti "Tu código es" di sekitar digitnya. Urai kode numeriknya dengan pola, bukan dengan mencocokkan kata-kata, karena templat berubah. Tim menguji di sini saat meluncur di Amerika Latin, memeriksa teks berbahasa Spanyol Rioplatense (bentuk vos lokal berbeda dari bahasa Spanyol buku teks), menjalankan operasi regional, atau melayani warga Argentina di luar negeri yang masih mendaftar dengan SIM +54.

Bisakah orang tanpa kemampuan coding memesan nomor +54?

Bisa. Staf dukungan, pertumbuhan, dan agensi dapat melakukan semuanya dari browser:

1. Buat akun di pendaftaran dengan email dan kode 6 digit, atau dengan masuk menggunakan Google.
2. Tambahkan dana ke dompet.
3. Buka OTP Gateway, pilih Argentina, lalu pilih layanan yang Anda uji.
4. Periksa harga yang ditampilkan, konfirmasi, dan salin nomor +54 ke layar verifikasi aplikasi.
5. Pantau aktivasi; kode muncul di sana begitu diterima.

Dasbor dan API memakai dompet dan aktivasi yang sama, sehingga seorang developer dapat melanjutkan nomor yang dipesan rekan setimnya melalui id aktivasi.

Kode Argentina tidak muncul. Apa langkah berikutnya?

Setiap aktivasi tetap terbuka selama 20 menit. Jika tidak ada yang masuk, atau Anda membatalkan lebih dulu, seluruh dana kembali ke dompet secara otomatis, jadi rute yang diam hanya memakan waktu Anda, bukan uang Anda. Kecepatan pengiriman bergantung pada layanan dan rutenya, jadi beri jendela itu kesempatan yang adil sebelum memutuskan bahwa ia gagal.

Lalu periksa daftar singkat ini:

• Minta kode sekali lagi dari dalam aplikasi, lalu biarkan jendela berjalan.
• Coba lagi nanti, atau pesan lewat rute lain untuk layanan yang sama.
• Pastikan layanan menerima nomor virtual sama sekali; sebagian menolaknya, dan itulah alasan pengembalian dana otomatis ada.
• Hindari memesan ulang dalam loop yang rapat dari CI. Tambahkan back-off dan batas percobaan ulang.

Tulisan kami tentang mengurangi kegagalan pengiriman OTP membahas pola lain untuk rute Argentina. Jaga setiap tes tetap sesuai ketentuan layanan terkait; Acceptable Use Policy OTP Route juga berlaku.

Bisakah kami mempertahankan nomor Argentina, dan bagaimana cara membayarnya?

Saat ini tidak ada nomor jangka panjang swalayan untuk Argentina. Jika tim Anda membutuhkan jalur +54 yang permanen, kirim email ke [email protected] dan jelaskan kasus penggunaannya; apakah hal itu dapat diatur bergantung pada aturan setempat dan tidak dijamin. Dedicated Virtual Numbers, yang tetap Anda miliki selama diperpanjang dan meneruskan SMS masuk ke webhook Anda, adalah produk Amerika Serikat dan Kanada mulai $1.95/bulan.

Penagihan berjalan lewat satu dompet USD prabayar tanpa biaya bulanan dan tanpa paket yang harus dipilih. Isi saldo dengan kartu atau USDT/USDC, dan setiap isi saldo menghasilkan faktur PDF lewat email. Detailnya ada di halaman harga. Sebelum memakai dana sungguhan, mintalah agar akun pengembangan Anda dialihkan ke sandbox, yang mengembalikan nomor dan kode simulasi sehingga Anda dapat berlatih seluruh alur Argentina dari awal sampai akhir.

Pertanyaan umum

Apa id negara Argentina di API OTP Route?

Yaitu ar. Kirimkan di kolom country pada POST /api/v1/activations dan di query string GET /api/v1/prices.

Perlukah saya menambahkan angka 9 saat mengetik nomor +54 di aplikasi?

Gunakan nomor persis seperti yang dikembalikan OTP Route. Di database Anda sendiri, simpan nomor seluler Argentina dalam format E.164, yang menyertakan 9 setelah +54 dan membuang 0 serta 15 domestik.

Berapa biaya menerima OTP SMS Argentina?

Mulai dari $0.20 per kode, bervariasi menurut layanan. Angka pastinya dikembalikan oleh GET /api/v1/prices dan ditampilkan sebelum Anda mengonfirmasi pesanan.

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

Bisa. Pesan aktivasi Argentina untuk aplikasi Anda atau layanan pihak ketiga dalam tes Anda, masukkan nomor +54, dan baca kodenya di dasbor atau dari webhook Anda.

Apakah nomor +54 yang sama akan berfungsi lagi untuk login bulan depan?

Tidak. Nomor gateway hanya mencakup satu kode dalam 20 menit. Untuk akun yang harus terus menerima kode, Dedicated Number di AS atau Kanada adalah pilihan yang tepat.

Dalam bahasa apa teks verifikasi Argentina dikirim?

Biasanya bahasa Spanyol, meski bergantung pada pengirim dan pengaturan bahasa akun. Ambil digitnya, jangan mengandalkan kata-kata di sekitarnya.

Apakah polling boleh digunakan sebagai pengganti webhook?

Boleh. Lakukan polling GET /api/v1/activations/{id} dengan interval sedang dan tetaplah jauh di bawah batas 300 permintaan per menit per akun.

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.