Cascade Cascade

FAQ

Как работает доставка OTP в Cascade

Cascade принимает API-запрос, доставляет код на реальный телефон через выбранный канал и проверяет ввод пользователя.

Quick Answer

Cascade принимает API-запрос, доставляет код на реальный телефон через выбранный канал и проверяет ввод пользователя.

Summary

"Пошаговый поток: телефон → send → сообщение на канал → код → verify → успе�

Key Takeaways

  • "Send и verify — два обязательны�
  • Канал можно не указывать — сработает дефолт компании.
  • Токены списываются за успешную доставку.

Содержание

  1. Поток за минуту

Поток за минуту

  1. Пользователь вводит номер у вас в форме.
  2. Ваш сервер нормализует телефон (для KZ часто 8…7…) и вызывает POST https://otp.kztusdt.kz/api/otp/send с Bearer-токеном.
  3. Cascade доставляет код через WhatsApp, Telegram или SMS — в зависимости от channel или настройки «Откуда отправлять» в кабинете.
  4. Пользователь вводит код.
  5. Сервер вызывает POST /otp/verify с тем же phone и purpose.
  6. При успехе вы открываете доступ к аккаунту или операции.

Повторная отправка на тот же номер ограничена примерно одним разом в 60 секунд — покажите таймер в интерфейсе. Не вызывайте API из браузера: ключ должен жить только на бэкенде. Если баланса не хватает, получите сообщение о недостатке токенов — см. пополнение и цены. Для коротких ссылок в том же сообщении передайте поле link. Больше сценариев — в use-cases, ошибки — в errors, обзор продукта — в о сервисе.