API проверки телефона: OTP, SMS и WhatsApp

Проверка телефона от Didit предоставляет надежный способ верификации телефонных номеров пользователей с помощью одноразовых кодов (OTP). Эта функция добавляет важный уровень безопасности в процесс верификации личности, гарантируя подлинность контактных данных пользователей. В уроке Didit Academy о чтении результатов верификации в разделе на отметке 8:08 рассматриваются проверка телефона и обнаружение дубликатов.

​

Как это работает

Наше решение для проверки телефона обеспечивает комплексную валидацию телефонных номеров через простой и удобный процесс. Система объединяет верификацию через OTP с передовой оценкой рисков, обеспечивая надежную проверку номеров в больших масштабах.

​

Возможности верификации

Наш сервис проверки телефона предлагает несколько ключевых возможностей для оптимизации процесса верификации:

​

Верификация через OTP

• Безопасная генерация кодов: случайно генерируемые одноразовые пароли
• Доставка по SMS: быстрая и надёжная доставка на мобильные устройства
• Настраиваемый срок действия: устанавливайте время истечения в соответствии с требованиями безопасности
• Повторные попытки: разрешайте пользователям запрашивать новые коды с соответствующим лимитом запросов
• Брендированные коды: SMS-коды содержат имя вашего бренда вместо стандартного сообщения без дополнительных затрат. См. Брендированные сообщения верификации.
• Собственный номер WhatsApp: коды WhatsApp могут отправляться с вашего собственного номера WhatsApp Business. См. Отправка кодов WhatsApp с собственного номера.

​

Брендированные сообщения верификации

SMS-коды верификации могут содержать имя вашего бренда, чтобы пользователи понимали, что сообщение отправлено вами:

123456: ваш код верификации для Acme Bank

Настраивается только имя. Остальной текст стандартизирован и зарегистрирован у мобильных операторов в каждой стране, что предотвращает попадание кодов в спам, а также переведён на язык получателя. Брендинг бесплатен: брендированный код стоит столько же, сколько и обычный. Укажите имя отправителя SMS в Business Console: в разделе Phone Verification → Settings нужного сценария или в подразделе White Label → SMS. Оно привязано к вашему приложению, а не к конкретному сценарию: им подписывается каждый SMS-код, отправленный приложением во всех сценариях и через отдельный API, как с настройкой White label, так и без неё. Какое имя указывается в коде (применяется первое совпадение):

1. options.sms_sender_name в POST /v3/phone/send/, для этого конкретного кода.
2. Имя отправителя SMS вашего приложения.
3. Только при отправках с White label (сценарий с настройкой White label или options.use_white_label_customization: true в API), ваше публичное имя White label.
4. В остальных случаях код отправляется без указания имени.

Имя отправителя содержит от 1 до 30 символов: только буквы, цифры, пробелы и знаки ’ & - !, не может состоять только из цифр, а слова разделяются одиночными пробелами. API отклоняет имя, не соответствующее этим правилам, с кодом 400 ещё до отправки кода.

• Каналы: имя добавляется в SMS-сообщения, включая SMS, отправленные в качестве резервного канала при сбое другого способа доставки. Коды WhatsApp отправляются с фиксированным сообщением и не содержат этого имени; чтобы в них отображалось имя вашей компании, отправляйте их с собственного номера.
• Лимит изменений в день: каждое приложение может начать использовать до двух новых имён в день (UTC), считая как новые имена отправителя, так и новые значения sms_sender_name. После этого коды отправляются с текущим именем приложения до наступления следующих суток, а код с новым именем из запроса отправляется с именем приложения. Имя, использованное ранее, повторно не учитывается.
• Приоритет доставки: проблемы с брендингом никогда не блокируют отправку кода. Если имя применить невозможно, код отправляется с именем приложения либо без него.

​

Собственный текст SMS и имя отправителя

Вы можете заменить текст SMS-кодов и имя отправителя, которое видят пользователи. Оба параметра настраиваются в Business Console в подразделе White Label → SMS. Они привязаны к вашему приложению, как и имя отправителя SMS, и применяются ко всем отправляемым им SMS-кодам во всех сценариях и через отдельный API. Собственный текст задаётся для каждого языка отдельно. Код отправляется с вашим текстом, если вы написали вариант для языка получателя; для всех остальных языков используется стандартный переведённый текст Didit. Используйте {code} для подстановки кода и, по желанию, {brand} для имени отправителя SMS, например: Acme: {code} is your login code for {brand}. Требования к тексту:

• должен содержать {code} ровно один раз и не содержать никаких других подстановок, кроме {code} и {brand};
• не должен содержать ссылок: операторы связи блокируют коды верификации, содержащие ссылки;
• должен помещаться в одно SMS с 8-значным кодом и 30-символьным именем: до 160 символов, либо до 70 символов при использовании знаков за пределами базовой латиницы (например, кириллицы, арабского письма или эмодзи).

Собственное имя отправителя состоит из 3-11 букв, цифр и пробелов, не может состоять только из цифр, например AcmeBank. Оно используется в странах, где Didit поддерживает кастомные имена отправителей (в странах, чьи операторы принимают имя отправителя без предварительной регистрации); во всех остальных странах ваши коды отправляются от имени Didit. Свяжитесь со службой поддержки, чтобы запросить поддержку страны, в которой требуется регистрация имени отправителя.

• Приоритет доставки: если код отправляется повторно через маршрут, который не поддерживает ваш текст или ваше имя отправителя, он отправляется со стандартным текстом Didit, подписывается вашим именем отправителя SMS и отправляется от имени Didit, поэтому код доставляется всегда.

​

Отправка кодов WhatsApp с собственного номера

По умолчанию коды WhatsApp отправляются с номера WhatsApp Business компании Didit. Вместо этого вы можете подключить собственный номер WhatsApp Business, чтобы пользователи получали коды с именем и с номера вашей компании. Подключите номер в Business Console: в разделе сценария Phone Verification → Settings → WhatsApp number выберите Connect WhatsApp number. Откроется окно входа: войдите в бизнес-аккаунт, управляющий вашим номером WhatsApp Business, затем выберите аккаунт WhatsApp Business и номер для отправки. После этого Didit зарегистрирует номер для отправки и создаст шаблон сообщения верификации. Для его редактирования требуются права на изменение настроек, как и в случае с именем отправителя SMS. Номер привязан к вашему приложению, а не к конкретному сценарию: после подключения он используется для отправки всех кодов WhatsApp этого приложения во всех сценариях и через отдельный API.

• Одобрение: перед тем как номер сможет отправлять коды, новое сообщение верификации должно пройти одобрение, что обычно занимает несколько минут. До подтверждения в карточке отображается статус ожидания, а коды тем временем продолжают отправляться с номера Didit.
• Текст сообщения: сообщения верификации в WhatsApp используют стандартный текст на языке пользователя: код, примечание о безопасности и кнопку копирования. Текст изменить нельзя, но отправителем выступает ваша компания.
• Доставка: если код не удаётся доставить через WhatsApp, он отправляется по SMS с подписью вашего имени отправителя SMS.
• Биллинг: сообщения, отправленные с вашего номера, тарифицируются в вашем аккаунте WhatsApp Business, поэтому Didit взимает за такие коды только сбор за верификацию ($0.02). Коды, отправленные по SMS, тарифицируются в обычном порядке.
• Требует внимания: если отправка с номера становится невозможной (например, был отозван доступ в бизнес-аккаунте), коды снова начинают отправляться с номера Didit, а в карточке появляется запрос на повторное подключение номера.
• Отключить номер можно в любой момент из этой же карточки. Коды снова будут отправляться с номера Didit; при этом сам номер и сообщение верификации останутся в вашем аккаунте WhatsApp Business.

​

Анализ номера телефона

• Валидация формата: проверка соответствия номера телефона корректному международному формату
• Определение оператора: определение поставщика телекоммуникационных услуг, связанного с номером
• Тип номера: различение мобильных, стационарных и VoIP-номеров
• Валидация страны: проверка соответствия номера телефона ожидаемому формату данной страны

​

Оценка риска

• Обнаружение одноразовых номеров: выявление временных номеров, используемых, чтобы избежать отслеживания
• Идентификация виртуальных номеров: маркировка номеров, которые могут быть виртуальными или работать через VoIP
• Мониторинг активности: отслеживание подозрительных паттернов при попытках верификации
• Проверка по спискам блокировки: сверка с внутренними списками номеров, ранее использовавшихся не по назначению

​

Цены

Проверка телефона тарифицируется за отправленное сообщение с прозрачной оплатой по факту использования: Скидка по вашему тарифу применяется только к комиссии Didit в размере $0.02; комиссия оператора передается по себестоимости и никогда не подлежит скидке. См. Скидки. Мы поддерживаем несколько каналов доставки с различными тарифами (доступность зависит от страны): → Цены на проверку телефона