FAQ
Частые вопросы о Cascade
Ответы простым языком: для бизнеса, разработчиков и команд, которые впервые сталкиваются с OTP.
Что такое Cascade?
Cascade — API и кабинет для исходящей доставки OTP-кодов на номер вашего пользователя через WhatsApp и Telegram. Это не аренда виртуальных номеров.
Что такое каскадная доставка?
Сначала сообщение идёт в WhatsApp или Telegram. Если мессенджер недоступен, Cascade может отправить SMS. Списание только за успешную доставку.
Cascade выдаёт виртуальные номера?
Нет. Cascade отправляет код на номер вашего пользователя и не сдаёт номера в аренду.
Сколько стоит доставка OTP?
WhatsApp и Telegram — 3 ₸ за успешную доставку. SMS после запуска канала — 8 ₸. Пакеты снижают среднюю цену единицы баланса.
Есть ли абонентская плата?
Нет. Вы платите только за купленный баланс и успешные доставки по тарифу канала.
Какие каналы доступны сейчас?
WhatsApp и Telegram доступны. SMS заложен в API и биллинг, но публичный SMS-провайдер пока не запущен.
Как подключить API?
Зарегистрируйте компанию, создайте Bearer-ключ в кабинете и вызывайте https://cascade.kz/api только со своего сервера. Обычно это занимает около 3 минут.
Как работают send и verify?
Send отправляет одноразовый код на номер пользователя. Verify проверяет введённый код на стороне Cascade и возвращает результат вашей системе.
Когда списывается баланс?
Баланс списывается по правилам успешной доставки выбранного канала, а не просто за попытку отправки.
Где хранить API-ключ?
Только на сервере: в secret-хранилище или переменных окружения. Не передавайте ключ в браузер или мобильное приложение.
Сколько действует OTP-код?
Стандартный TTL шестизначного кода — 5 минут. Повторная отправка и лимиты описаны в документации.
Что делать, если код не пришёл?
Проверьте статус доставки в кабинете или через API, убедитесь что номер в международном формате и канал доступен. При необходимости повторите отправку с учётом cooldown.
Как пополнить баланс?
В кабинете можно купить пакет или пополнить баланс от 100 единиц. После регистрации начисляется 1000 ₸ стартового баланса.
Чем Cascade отличается от обычного SMS-шлюза?
Фокус на OTP: мессенджеры дешевле SMS, есть каскад каналов, verify API, webhooks и оплата за успешную доставку.
Где посмотреть документацию и OpenAPI?
Документация — на /docs, справочник эндпоинтов — на /api, схема — /openapi.yaml.