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.