Memverifikasi alur pendaftaran Tiongkok (+86) dengan API perutean OTP

Mengapa pasar Tiongkok perlu rencana pengujian verifikasi tersendiri?

Tiongkok memiliki salah satu ekosistem seluler terbesar di dunia, dan sebagian besar berada di dalam platform domestik, bukan aplikasi global yang biasanya diuji lebih dulu oleh tim dari Barat. Kartu SIM di sana didaftarkan dengan identitas asli, sehingga layanan lokal menganggap nomor telepon sebagai sinyal identitas yang kuat dan sering lebih ketat dalam menerima nomor tertentu.

Hal itu memengaruhi cara seorang insinyur QA memandang rute Tiongkok:

• Perdagangan lintas negara. Penjual dan pembeli di Alibaba dan AliExpress mengonfirmasi nomor telepon saat mendaftar atau mengubah data akun, sehingga tim marketplace perlu melihat pesan-pesan itu dari ujung ke ujung.
• Teks berbahasa Mandarin. Kode dari pengirim domestik biasanya tiba dalam bahasa Mandarin Sederhana, sering diawali nama pengirim dalam tanda kurung 【】. Parser yang mencari kata "code" dalam bahasa Inggris akan melewatkannya.
• Pengodean. Teks Mandarin dikirim sebagai SMS Unicode, jadi simpan isi pesan sebagai UTF-8 dan ambil angkanya dengan pola yang mengabaikan karakter di sekitarnya.

Menggunakan nomor +86 untuk pengujian pada rute sungguhan akan mengungkap ketiga masalah ini sebelum pelanggan menemukannya, dan di situlah perutean OTP ke jalur operator Tiongkok yang nyata berguna.

Bagaimana cara menyimpan nomor seluler +86?

Nomor seluler daratan Tiongkok terdiri dari 11 digit dan diawali angka 1. Berbeda dengan telepon rumah, yang dihubungi secara domestik dengan awalan trunk 0 ditambah kode area, nomor seluler sama sekali tidak memakai awalan trunk, sehingga bentuk E.164-nya cukup +86 diikuti 11 digit tersebut.

Beberapa kebiasaan normalisasi akan menghemat waktu debugging:

• Hapus spasi dan tanda hubung; pengguna sering mengetik nomor dalam kelompok 3-4-4.
• Ubah 0086 atau 86 di awal menjadi +86 sebelum disimpan, dan jangan pernah menambahkan 0 di depan nomor seluler.
• Validasi panjang setelah normalisasi: 11 digit nasional untuk seluler, tidak lebih.

Simpan satu kolom kanonik dalam format E.164 dan atur tampilan hanya di bagian tepi. Nomor yang dikembalikan oleh sebuah aktivasi sudah mengikuti bentuk kanonik itu, sehingga cocok dijadikan fixture untuk unit test normalizer Anda sendiri.

Aplikasi apa saja yang bisa mengirim kode ke rute Tiongkok saat ini?

Rute Tiongkok saat ini mencakup lebih dari 1.300 layanan. Yang populer dalam snapshot langsung antara lain WeChat, Alibaba, AliExpress, Microsoft & Outlook, LinkedIn, Telegram, WhatsApp, Google (Gmail & YouTube), TikTok, Amazon, Discord, ChatGPT (OpenAI), dan Claude.

Ketersediaan berubah sepanjang hari karena mitra operator kami menambah dan menarik kapasitas, jadi anggap daftar itu sebagai titik awal. Panggil GET /api/v1/services dan GET /api/v1/countries untuk melihat kondisi terkini, jangan menanam id layanan secara permanen di matriks pengujian.

Seperti apa alur API untuk id negara cn?

Buat kunci Bearer (berawalan or_live_) di konsol Developer, lalu arahkan klien Anda ke https://otproute.com/api/v1. Satu putaran API OTP Tiongkok yang umum berjalan seperti ini, dan langkah yang sama memungkinkan Anda menerima SMS OTP Tiongkok untuk layanan apa pun yang didukung:

1. Minta harga langsung untuk pasangan yang akan diuji lewat GET /api/v1/prices?country=cn&service=wechat.
2. Kirim POST /api/v1/activations dengan isi {"service": "wechat", "country": "cn"} dan simpan id aktivasi yang dikembalikan.
3. Masukkan nomor +86 ke formulir pendaftaran produk yang diuji.
4. Biarkan webhook Anda menangkap activation.sms_received; tanpa webhook, periksa GET /api/v1/activations/{id} setiap beberapa detik.
5. Panggil POST /api/v1/activations/{id}/cancel jika pengujian dibatalkan, yang langsung melepas dana yang ditahan.

Pengiriman webhook membawa X-OTPRoute-Signature dalam format t=<unix>,v1=<hex>. Hitung ulang HMAC-SHA256 atas <t>.<raw body> dengan secret endpoint, bandingkan dalam waktu konstan, dan buang timestamp yang sudah lama. Setiap akun mendapat hingga 10 kunci, 5 endpoint webhook, dan 300 permintaan per menit; referensi lengkap ada di dokumentasi API.

Bisakah orang tanpa keahlian kode memesan nomor Tiongkok?

Bisa. Manajer produk dan staf dukungan dapat melakukan semuanya dari dasbor:

1. Buka OTP Gateway, pilih Tiongkok, lalu pilih layanannya.
2. Periksa harga yang ditampilkan sebelum memesan.
3. Salin nomor +86 ke aplikasi yang sedang diverifikasi.
4. Pantau kartu aktivasi; teks pesan akan muncul di sana begitu diterima.

Jendela 20 menit dan aturan pengembalian dana yang sama berlaku, jadi pemeriksaan manual atas layar onboarding yang dilokalkan tidak memakan biaya jika aplikasi tidak mengirim apa pun.

Apa yang harus dicoba jika kode Tiongkok tidak tiba?

Tidak adanya pesan biasanya berarti layanan menolak mengirim ke nomor itu atau rute sedang sibuk, bukan berarti integrasi Anda rusak. Telusuri dengan tenang:

• Biarkan seluruh jendela berjalan; sebagian pengirim mencoba ulang menurut jadwalnya sendiri.
• Pastikan layanan memang menerima nomor virtual. Platform dengan aturan identitas asli sering kali tidak menerimanya, dan pengembalian dana otomatis ada tepat untuk kasus itu.
• Kembali setelah jeda, atau jalankan skenario yang sama lewat rute layanan lain.
• Hindari memesan ulang dalam putaran cepat. Cara itu menghabiskan batas laju dan jarang mengubah hasil.

Panduan kami tentang mengurangi kegagalan pengiriman OTP membahas desain percobaan ulang lebih dalam.

Bisakah saya menyimpan nomor +86 dalam jangka panjang, dan bagaimana penagihannya?

Tidak ada jalur mandiri untuk nomor jangka panjang di Tiongkok. Dedicated Numbers adalah produk untuk Amerika Serikat dan Kanada, mulai $1.95/month, dengan SMS masuk, SMS keluar, dan panggilan lewat browser. Jika tim Anda membutuhkan saluran Tiongkok yang bertahan lama, kirim email ke [email protected] untuk bertanya; ketersediaannya bergantung pada aturan setempat dan tidak dijanjikan.

Dana disimpan dalam satu dompet USD prabayar, tanpa tagihan bulanan dan tanpa paket yang harus dipilih. Pengujian Tiongkok memakai saldo itu, yang bisa Anda isi ulang dengan kartu atau USDT/USDC, dan faktur PDF dikirim lewat email setelah setiap isi ulang. Rinciannya ada di halaman harga, dan ikhtisar nomor virtual menjelaskan saluran AS dan Kanada. Untuk pekerjaan integrasi, minta mode sandbox: mode ini mengembalikan nomor dan kode simulasi sehingga pipeline dapat diuji tanpa menyentuh dana dompet.

Pertanyaan umum

Bisakah saya menguji alur registrasi WeChat atau Alibaba tanpa SIM Tiongkok?

Anda bisa memesan nomor +86 untuk layanan tersebut lewat OTP Route dan membaca kodenya di dasbor atau melalui API. Beberapa platform menolak nomor virtual; dalam kasus itu aktivasi dikembalikan dananya secara otomatis.

Apa id negara untuk Tiongkok di API OTP Route?

Gunakan cn di mana pun id negara diminta, misalnya dalam GET /api/v1/prices?country=cn&service=<id>.

Apakah pesan verifikasi Tiongkok datang dalam bahasa Inggris?

Pengirim domestik biasanya menulis dalam bahasa Mandarin Sederhana, sedangkan aplikasi global sering mengirim bahasa Inggris atau bahasa yang sesuai dengan akun. Bangun ekstraksi kode Anda berdasarkan digit, bukan kata kunci.

Berapa lama aktivasi +86 tetap terbuka?

Dua puluh menit. Jika tidak ada SMS yang masuk sebelum waktu habis, atau Anda membatalkannya lebih dulu, seluruh jumlahnya kembali ke dompet Anda.

Apakah nomor verifikasi Tiongkok cocok untuk login berulang?

Tidak. Setiap aktivasi hanya menerima satu kode lalu berakhir, jadi cocok untuk pengujian pendaftaran dan onboarding, bukan untuk akun yang harus masuk lagi bulan depan.

Aturan apa yang berlaku untuk penggunaan nomor +86?

Patuhi ketentuan setiap platform serta Kebijakan Penggunaan yang Dapat Diterima OTP Route. Produk ini dimaksudkan untuk menguji alur verifikasi milik Anda sendiri dan menjalankan akun bisnis yang sah, bukan untuk pendaftaran massal.

Bisakah job CI memakai nomor Tiongkok tanpa membayar?

Atas permintaan, akun pengembangan dapat dialihkan ke mode sandbox, yang mengembalikan nomor dan kode simulasi sehingga pengujian API verifikasi SMS Anda berjalan dari ujung ke ujung secara gratis.

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.