Langsung ke konten utama
The Phone Verification API menyediakan alur dua langkah: mengirim kode sekali pakai ke nomor telepon, lalu memverifikasi kode tersebut. Sistem mendeteksi jenis operator, nomor virtual, dan telepon sekali pakai.

​
Endpoint

Kirim Kode Telepon

POST /v3/phone/send/: Kirim kode verifikasi sekali pakai melalui SMS.

Periksa Kode Telepon

POST /v3/phone/check/: Verifikasi kode dan ambil data risiko telepon.

Nilai Risiko Telepon

POST /v3/phone/risk/: Nilai operator, jenis saluran, porting, dan risiko penipuan tanpa mengirim OTP.

​
Cara kerjanya

  1. Panggil Kirim Kode Telepon dengan nomor telepon dalam format E.164 (misalnya, +14155552671)
  2. Pengguna menerima kode melalui SMS (berlaku selama 5 menit)
  3. Panggil Periksa Kode Telepon dengan nomor telepon dan kode
  4. Terima hasil verifikasi beserta sinyal risiko (jenis operator, deteksi nomor virtual)

​
Saluran pengiriman

Didit mendukung beberapa saluran, bergantung pada ketersediaan di setiap negara:

​
Sinyal risiko

Untuk struktur respons lengkap, lihat Laporan Verifikasi Telepon.

​
Gangguan penyedia

Jika penyedia telepon di sisi hulu gagal merespons permintaan pengiriman atau pemeriksaan, kedua endpoint mengembalikan 502 dengan code: "phone_provider_unavailable", alih-alih error umum. Permintaan ini aman untuk dicoba ulang, tidak ditagih, dan tidak mengurangi jatah percobaan pada batas per jam per nomor. Gunakan code untuk percabangan logika, bukan mengurai pesan detail, karena teks pesan bukan kontrak yang stabil.
Terakhir diubah pada 7 November 2026