Начало работы
Интеграция / SDK
Проверка пользователей
Верификация бизнеса
Мониторинг транзакций
Журнал измененийЭндпоинты
Отправка кода на телефон
POST /v3/phone/send/ — Отправка одноразового кода подтверждения по SMS.Проверка кода телефона
POST /v3/phone/check/ — Проверка кода и получение данных о рисках, связанных с номером телефона.Оценка риска телефона
POST /v3/phone/risk/ — Оценка оператора, типа линии, переноса номера и риска мошенничества без отправки OTP.Как это работает
- Вызовите Отправку кода на телефон, передав номер телефона в формате E.164 (например,
+14155552671) - Пользователь получает код по SMS (действителен 5 минут)
- Вызовите Проверку кода телефона, передав номер телефона и код
- Получите результат проверки и сигналы риска (тип оператора, определение виртуального номера)
Каналы доставки
Didit поддерживает несколько каналов в зависимости от доступности в стране:Сигналы риска
Полную структуру ответа см. в Отчёт о проверке телефона.
Сбои у провайдера
Если провайдер телефонии не отвечает на запрос отправки или проверки, оба эндпоинта возвращают502 с code: "phone_provider_unavailable" вместо общей ошибки. Повторный запрос в этом случае безопасен, не тарифицируется и не расходует попытку из почасового лимита на номер. Ориентируйтесь на code, а не разбирайте текст detail: формулировка сообщения не является стабильным контрактом.