> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Verifikasi Telepon API: OTP SMS & Sinyal Risiko

> Verifikasi OTP SMS dari Didit dengan deteksi operator, nomor virtual, dan nomor sekali pakai. Bayar per penggunaan: harga operator + $0.02, tanpa kontrak.

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

> [card] [Kirim Kode Telepon](https://docs.didit.me/id/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/`: Kirim kode verifikasi sekali pakai melalui SMS.

> [card] [Periksa Kode Telepon](https://docs.didit.me/id/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/`: Verifikasi kode dan ambil data risiko telepon.

> [card] [Nilai Risiko Telepon](https://docs.didit.me/id/standalone-apis/phone-risk.md)
>
> `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:

| Saluran | Deskripsi |
| - | - |
| SMS | Pesan teks standar |
| WhatsApp | Pesan WhatsApp |
| Telegram | Pesan Telegram |
| RCS | Rich Communication Services |
| Viber | Pesan Viber |

## Sinyal risiko

| Sinyal | Deskripsi |
| - | - |
| `is_disposable` | Nomor telepon sementara atau sekali pakai |
| `is_virtual` | Nomor VoIP atau virtual |
| `carrier.type` | `mobile`, `landline`, atau `voip` |

Untuk struktur respons lengkap, lihat [Laporan Verifikasi Telepon](https://docs.didit.me/id/core-technology/phone-verification/overview.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.