Cara tim menerima kode SMS DiDi untuk pengujian dan operasional

Situasinya: akun mobilitas yang bergantung pada satu nomor telepon

DiDi adalah platform transportasi online dan mobilitas, dan seperti kebanyakan aplikasi di kategori itu, ia memperlakukan nomor ponsel sebagai inti akun. Kode SMS biasanya diminta saat pendaftaran, saat seseorang login di perangkat baru, dan saat pemulihan akun; onboarding pengemudi dan kurir bersandar pada pemeriksaan yang sama.

Hal ini menimbulkan gesekan bagi pekerjaan bisnis yang sah. Perusahaan yang menjalankan akun penumpang korporat tidak ingin akun itu terikat pada ponsel pribadi satu karyawan. Agensi yang mengelola perjalanan klien membutuhkan langkah verifikasi yang dapat diselesaikan orang selain penanda tangan awal. Tim QA yang membangun produk yang terhubung ke akun DiDi ingin melatih alurnya tanpa mengoper ponsel pribadi berkeliling kantor. Nomor virtual untuk DiDi, dipakai sekali per verifikasi, menjaga langkah-langkah itu di luar SIM pribadi siapa pun.

Negara mana yang dapat menyediakan nomor telepon DiDi?

Rute didi saat ini mencakup 198 negara. Tim paling sering memulai dari pasar dengan permintaan transportasi online yang tinggi, seperti Meksiko, Brasil, Chili, Kolombia, Peru, Argentina, Kosta Rika, Panama, Republik Dominika, Ekuador, Australia, Selandia Baru, Jepang, dan Hong Kong.

Pilih negara dengan sengaja. Akun penumpang yang akan dipakai di Santiago sebaiknya diverifikasi dengan nomor Chili, dan uji regresi untuk layar pendaftaran Meksiko memerlukan nomor Meksiko. Ketidakcocokan antara negara nomor dan pasar akun adalah penyebab umum pengujian yang lolos di atas kertas tetapi gagal terhadap aplikasi sungguhan. Daftar lengkapnya ada di bawah negara.

Bagaimana alur API kode verifikasi DiDi berjalan?

Alur DiDi memakai URL dasar yang sama dengan setiap rute lain, https://otproute.com/api/v1, dengan kunci or_live_ di header Authorization.

1. Kueri GET /api/v1/prices?country=<id>&service=didi untuk melihat apakah rute terbuka dan berapa biayanya saat ini.
2. Buat pesanan dengan POST /api/v1/activations dan isi seperti {"service": "didi", "country": "mx"}.
3. Masukkan nomor yang dikembalikan di layar DiDi yang Anda uji dan minta SMS.
4. Baca kode dari webhook, atau polling GET /api/v1/activations/{id} sampai muncul.
5. Jika pengujian pemesanan perjalanan ditinggalkan di tengah jalan, lepaskan nomor lewat POST /api/v1/activations/{id}/cancel.

Satu akun dapat memiliki hingga 10 kunci dan 5 endpoint webhook, dalam batas 300 permintaan per menit.

Bagaimana sebaiknya handler webhook DiDi ditulis?

Berlanggananlah ke activation.sms_received, dan juga ke activation.expired dan activation.cancelled agar pengujian Anda tahu kapan harus berhenti menunggu. Setiap pengiriman membawa X-OTPRoute-Signature: t=<unix>,v1=<hex>; hitung ulang HMAC-SHA256 atas "<t>.<raw body>" dengan secret endpoint, bandingkan dalam waktu konstan, dan buang apa pun dengan stempel waktu basi.

Event dipatok pada ID aktivasi, jadi simpan ID itu saat Anda memesan dan perlakukan pengiriman kedua untuk ID yang sama sebagai tanpa aksi. Idempotensi itu penting karena webhook yang dicoba ulang tidak boleh mengirimkan kode DiDi dua kali. Jika webhook masuk sulit diterapkan di lingkungan Anda, polling endpoint aktivasi juga berfungsi. Artikel penangkapan OTP berbasis webhook membandingkan kedua pendekatan.

Menerima OTP DiDi dari dasbor

Staf operasional dapat melewati API sepenuhnya. Masuk, isi dompet, buka OTP Gateway, cari DiDi, pilih negara yang sesuai dengan akun, dan periksa harga yang ditampilkan sebelum mengonfirmasi. Nomor muncul pada kartu aktivasi, dan kodenya tampil di sana setelah DiDi mengirimnya. Aktivasi tetap terbuka selama 20 menit.

Mengapa kode DiDi mungkin gagal tiba?

Beberapa sebab biasa menjelaskan aktivasi yang kosong:

• DiDi, seperti banyak platform, dapat menolak nomor virtual pada rute tertentu atau di waktu tertentu.
• Rute negara yang dipilih bisa sedang sibuk; ketersediaan bergerak sepanjang hari.
• Aplikasi mungkin membatasi permintaan berulang dari perangkat atau sesi yang sama selama pengujian.

Pemecahannya adalah sabar, bukan agresif. Biarkan jendela selesai, coba lagi nanti atau dengan negara lain yang masih sesuai dengan pengujian, dan hindari memesan ulang dalam putaran cepat. Anda tidak pernah membayar untuk kegagalan: ketika jendela berakhir atau Anda membatalkan, seluruh jumlahnya kembali ke dompet secara otomatis.

Kapan akun DiDi sebaiknya memakai Dedicated Number, dan aturan apa yang berlaku?

Aktivasi sekali pakai cocok untuk satu verifikasi. Jika akun DiDi yang sama harus login lagi bulan depan, misalnya akun penumpang staging atau login korporat bersama, Dedicated Number menjaga saluran tetap di bawah kendali Anda. Nomor ini ditawarkan hanya di Amerika Serikat dan Kanada, mulai $1.95/bulan, dengan SMS masuk di dasbor dan pada webhook Anda. Lihat nomor virtual untuk detailnya.

Gunakan OTP Route hanya untuk menguji dan mengoperasikan produk serta akun sah milik Anda sendiri. Ikuti ketentuan DiDi, tetap satu akun per orang atau bisnis nyata, dan perhatikan bahwa Kebijakan Penggunaan yang Dapat Diterima OTP Route berlaku. OTP Route tidak berafiliasi dengan DiDi, yang namanya merupakan merek dagang pemiliknya.

Pertanyaan umum

Apa ID layanan untuk verifikasi SMS DiDi untuk pengujian?

Gunakan didi pada kolom service, bersama ID negara dari pasar yang Anda uji.

Bisakah saya menerima OTP DiDi untuk akun Meksiko tanpa SIM Meksiko?

Bisa, jika rute Meksiko terbuka: pesan nomor dengan negara mx dan layanan didi, lalu baca kodenya lewat API atau di dasbor.

Apakah saya membayar jika DiDi tidak pernah mengirim kodenya?

Tidak. Aktivasi tanpa SMS dalam 20 menit, atau yang Anda batalkan, dikembalikan penuh ke dompet.

Apakah DiDi menerima semua nomor virtual?

Belum tentu. Beberapa rute mungkin ditolak, jadi coba lagi nanti atau gunakan negara lain yang sesuai.

Bisakah saya menguji integrasi DiDi tanpa memakai dana dompet?

Bisa. Akun pengembangan dapat dialihkan ke sandbox atas permintaan, yang mengembalikan nomor dan kode simulasi untuk pengujian menyeluruh.

Bagaimana cara membayar aktivasi DiDi?

Isi dompet USD prabayar lewat kartu atau USDT/USDC; tidak ada biaya bulanan, dan setiap isi ulang disertai faktur PDF. Tarif terkini ada di halaman harga.

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.