Jalur developer menuju kode verifikasi Swiss (+41)

Permintaan API apa yang mengembalikan kode Swiss?

API OTP Swiss ini memakai permukaan kecil yang sama seperti untuk negara lain, dengan ch sebagai id negara. Lakukan autentikasi dengan kunci Bearer (awalan or_live_) yang dibuat di Developer console; satu akun dapat memiliki hingga 10 kunci.

1. Ambil id dari GET /api/v1/services dan GET /api/v1/countries, lalu simpan di cache antar-eksekusi.
2. Periksa GET /api/v1/prices?country=ch&service=<id>. Responsnya memuat harga saat ini dan apakah jalur sedang terbuka.
3. Kirim POST /api/v1/activations dengan {"service": "whatsapp", "country": "ch"} atau layanan lain yang sedang Anda uji. Simpan id aktivasi yang dikembalikan.
4. Masukkan nomor +41 ke kolom telepon di produk Anda sendiri.
5. Baca hasilnya dari GET /api/v1/activations/{id} atau dari webhook; batalkan dengan rapi lewat POST /api/v1/activations/{id}/cancel.

GET /api/v1/balance sebaiknya ada di langkah persiapan suite pengujian Anda. Batas laju adalah 300 permintaan per menit per akun, cukup longgar untuk beberapa job paralel yang melakukan polling dengan interval santai. Referensi endpoint: dokumentasi.

Polling atau webhook untuk aktivasi +41?

Polling menjaga skrip cepat tetap sederhana. Webhook lebih unggul begitu pengujian berjalan paralel, karena tidak ada proses yang perlu menunggu saat SMS menuju Zurich masih dalam perjalanan.

OTP Route memungkinkan Anda mendaftarkan hingga lima endpoint; langganan masing-masing ke activation.sms_received, activation.expired, dan activation.cancelled. Verifikasi setiap pengiriman sebelum dipercaya: ambil bagian t dan v1 dari X-OTPRoute-Signature, hitung HMAC-SHA256 atas "<t>.<raw body>" dengan secret endpoint, bandingkan dalam waktu konstan, dan tolak timestamp di luar toleransi singkat. Gunakan id aktivasi sebagai kunci pemrosesan agar pengiriman ulang tidak berdampak apa-apa.

Untuk pembahasan lebih dalam soal pemeriksaan tanda tangan, lihat mengamankan webhook OTP dengan HMAC.

Seperti apa nomor Swiss di database Anda?

Di dalam negeri, nomor Swiss diawali prefiks trunk 0, misalnya ponsel yang ditulis 079 123 45 67. Secara internasional nol itu hilang: bentuk E.164-nya adalah +41 79 123 45 67, dengan sembilan digit setelah kode negara. Rentang ponsel berada di blok 07x. Simpan string kanonis +41… dan format hanya saat ditampilkan; jika tidak, deduplikasi dan pencarian akan rusak ketika satu bentuk menulis 079 dan yang lain +4179.

Bahasa adalah keunikan Swiss lainnya. Karena Jerman, Prancis, Italia, dan Romansh semuanya bahasa nasional, SMS verifikasi bisa tiba dalam salah satu dari tiga bahasa pertama tergantung penanganan locale oleh pengirim, dan banyak aplikasi cukup beralih ke bahasa Inggris. Jika produk Anda dilokalkan per wilayah, kode +41 yang sungguhan adalah cara murah untuk memastikan templat yang tepat terkirim.

Tim melakukan pengujian di sini sebelum meluncurkan produk fintech atau e-commerce ke pasar Swiss, saat mendukung staf yang mengelola akun bisnis dari Jenewa atau Basel, atau saat memvalidasi alur lintas negara yang juga menyentuh Liechtenstein, yang memakai kode +423 sendiri.

Layanan yang bisa diverifikasi dengan nomor verifikasi Swiss

Snapshot terkini untuk ch mencantumkan Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI), dan Claude, di antara yang lain. Secara total Swiss memiliki lebih dari 1.700 layanan di OTP Gateway.

Karena ketersediaan berubah sepanjang hari, anggap daftar itu sebagai titik awal dan kueri data langsung saat runtime. Harness yang memeriksa harga terlebih dahulu dan menandai tes sebagai dilewati ketika jalur tertutup menghasilkan laporan yang jauh lebih bersih daripada yang mencoba ulang secara membabi buta.

Mengatasi aktivasi Swiss yang tetap kosong

Bila nomor +41 tidak menerima apa pun, telusuri hal berikut sebelum menyentuh kode Anda:

• Beri kesempatan pada seluruh jendela 20 menit; beberapa platform mengantrekan pesan keluar.
• Periksa apakah layanan menolak nomor virtual. Beberapa memang menolak, dan itulah kasus yang ditangani pengembalian dana otomatis.
• Coba lagi setelah jeda, atau gunakan jalur layanan lain, jangan memesan ulang berulang-ulang dalam putaran ketat.
• Batalkan aktivasi yang ditinggalkan agar dana segera kembali.

Artikel tentang routing negara untuk OTP menjelaskan mengapa aplikasi yang sama bisa berperilaku berbeda dari satu jalur negara ke jalur lainnya.

Adakah nomor Swiss jangka panjang?

Bukan sebagai produk swalayan. Untuk Swiss, OTP Route hanya menawarkan nomor sekali pakai melalui OTP Gateway.

Dedicated Virtual Numbers, yang Anda pertahankan selama diperpanjang, terbatas di Amerika Serikat dan Kanada dan mulai dari $1.95/month. Jika Anda benar-benar memerlukan jalur Swiss yang permanen, tulis ke [email protected] dan jelaskan kasus penggunaannya; jawabannya bergantung pada aturan setempat dan tidak dapat dijanjikan sebelumnya.

Dompet, faktur, dan sandbox untuk routing OTP Swiss

Anda membayar sesuai pemakaian dari satu dompet USD prabayar. Tidak ada biaya bulanan dan tidak ada paket yang perlu dipilih. Isi saldo dengan kartu atau USDT/USDC, dan faktur PDF dikirim lewat email untuk setiap top-up, sehingga pembukuan tetap rapi bagi entitas Swiss yang merekonsiliasi dalam franc.

Untuk pekerjaan integrasi, minta mode sandbox pada akun pengembangan. Mode ini mengembalikan nomor dan kode simulasi sehingga seluruh jalur API verifikasi SMS dapat diuji tanpa memakai saldo dompet. Gunakan aktivasi sungguhan hanya untuk produk dan akun Anda sendiri, sesuai ketentuan tiap layanan dan Acceptable Use Policy OTP Route. Halaman solusi pengujian QA menunjukkan cara tim memasukkannya ke dalam pemeriksaan rilis.

Pertanyaan umum

Id negara apa yang dipakai API untuk Swiss?

Swiss adalah ch. Permintaan untuk Swiss membawa nilai dua huruf itu di mana pun negara diminta, termasuk di body aktivasi.

Bisakah saya memeriksa alur login Swiss tanpa memiliki SIM Swiss?

Ya. Nomor +41 untuk pengujian dari OTP Gateway menerima kodenya, yang lalu Anda baca di dashboard atau lewat API.

Haruskah angka 0 dipertahankan saat menyimpan nomor ponsel Swiss?

Tidak. Angka 0 adalah prefiks trunk domestik; simpan bentuk E.164 yang diawali +41 diikuti sembilan digit.

Dalam bahasa apa SMS verifikasi Swiss akan tiba?

Tergantung pengirim: Jerman, Prancis, Italia, atau Inggris semuanya umum. Ekstrak kode dengan pola digit, bukan dengan kalimat yang tetap.

Berapa biaya SMS OTP Swiss?

Mulai $0.20 per kode, dengan harga pasti per layanan dikembalikan oleh GET /api/v1/prices sebelum Anda memesan.

Apa yang terjadi pada uang saya jika kode tidak tiba?

Dana kembali ke dompet Anda secara otomatis saat jendela waktu berakhir atau saat Anda membatalkan aktivasi.

Apakah Liechtenstein tercakup oleh jalur Swiss?

Tidak, Liechtenstein memiliki kode negara +423 sendiri dan halamannya sendiri di daftar negara, jadi pesanlah secara terpisah.

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.