OTP Verify

Одноразовые коды по SMS

Подтверждайте регистрацию, вход и платежи кодом на телефон пользователя. Ваше приложение запускает проверку и передаёт введённый код. E-Numbers доставляет SMS.

Защита каждого важного шага

01

Защита аккаунтов

Одноразовый код для регистрации, входа, восстановления пароля и подтверждения платежа.

02

Два запроса к API

Создайте проверку и отправьте код, который ввёл пользователь. Тот же REST API, что и у остального кабинета E-Numbers.

03

Ваш отправитель и текст

Отправляйте с номера на вашем аккаунте или с общего имени. Текст SMS можно задать на русском, английском или украинском.

Можно подключать сразу

Bearer-токен, JSON и тот же базовый адрес, что у остального API.

Документация API
POST /api/v1/verifications
{
  "destination": "+4915112345678",
  "channel": "sms",
  "locale": "en"
}

POST /api/v1/verifications/{id}/check
{ "code": "482913" }

Отправка. Доставка. Проверка.

1

Создайте проверку

Сервер вызывает API и передаёт номер телефона. Мы создаём 6-значный код и ставим SMS в очередь.

2

Доставьте код

Сообщение уходит тем же каналом исходящих SMS, что и остальной трафик, и списывается с баланса аккаунта.

3

Проверьте код

Пользователь вводит код, сервер отправляет его нам. Совпадение в течение 10 минут возвращает статус verified.

Где это используют

Подтверждение номера

Убедитесь, что новый аккаунт принадлежит человеку, у которого есть указанный телефон.

Вход и 2FA

Запрашивайте новый код, когда вход идёт с незнакомого устройства.

Восстановление доступа

Перед сменой пароля человек подтверждает, что телефон на аккаунте у него.

Платежи и изменения профиля

Подтверждайте реквизиты выплаты и другие чувствительные изменения до того, как применить их.

Оплачивается SMS

Проверка кода не добавляет отдельную плату. Доставка идёт по тарифу исходящих SMS и списывается с баланса.

SMS с баланса

Каждый код — исходящее сообщение. Действует обычный тариф отправки для этого направления.

Проверка входит в услугу

Отправка кода на проверку, чтение статуса и истёкшая попытка не создают дополнительной платы.

Новый код закрывает предыдущий

Новая проверка на тот же номер закрывает предыдущий ожидающий код. Активен только один.

Тарифы на исходящие SMS

Что можно настроить

Срок 10 минут

Ожидающий код истекает сам. После этого статус — expired.

Пять попыток

Неверный код уменьшает число оставшихся попыток. Пятая ошибка переводит проверку в failed.

Текст сообщения

Передайте шаблон с {code} ровно один раз, до 160 символов, без ссылки.

Имя отправителя

Укажите from — виртуальный номер на аккаунте. Пустое поле использует общего отправителя.

Статус по запросу

Проверка бывает pending, verified, expired или failed. Статус можно запросить по id.

Языки

Готовые тексты на русском, английском и украинском. Язык задаётся полем locale.

Вопросы

OTP Verify создаёт одноразовый код, отправляет его по SMS и проверяет код, который прислал ваш пользователь. Вызов идёт с бэкенда по API-токену аккаунта.

POST /api/v1/verifications с номером в международном формате, например +4915112345678. В ответе будут id и статус pending. Сам код есть только в SMS.

POST /api/v1/verifications/{id}/check с кодом, который ввёл пользователь. Совпадение возвращает статус verified. Ошибка показывает, сколько попыток осталось.

SMS списывается как обычное исходящее сообщение с баланса. Чтение и проверка кода отдельной платы не добавляют.

Да. Передайте template с плейсхолдером {code} ровно один раз. Готовое сообщение — не длиннее 160 символов и без ссылки.

Оставьте from пустым — уйдёт общий отправитель. Или передайте номер, который арендован на этом же аккаунте.

Добавьте подтверждение телефона в свой сценарий

Создайте аккаунт, пополните баланс и отправьте первый код через API.