Каналы и оплата
Порядок каналов
Канал выбирает VERYO. Первым пробуется самый дешёвый включённый канал: Telegram, затем WhatsApp, затем SMS. Если канал не доставил код, сессия переходит к следующему, более дорогому. Код при этом не меняется.
Начальный канал определяется так:
options.preferred_channelиз запроса, если этот канал включён.- Канал, который доставил код этому номеру в вашем аккаунте, если номер подтверждён за последние 30 дней.
- Самый дешёвый включённый канал.
Каскад идёт только в сторону более дорогих каналов. Запрос с preferred_channel: "sms" не перейдёт на Telegram, даже если SMS не дойдёт.
Когда код считается доставленным
| Канал | Доставлено | Переход к следующему каналу |
|---|---|---|
| Telegram | Статус «доставлено» или «прочитано» | У номера нет Telegram, ошибка или нет подтверждения в отведённое время |
| Отчёт о доставке | Ошибка или нет отчёта в отведённое время | |
| SMS | Отчёт оператора о доставке | Следующего канала нет, сессия завершается как failed |
На подтверждение от мессенджера отводится около 10 секунд. Если SMS принято оператором, но отчёта нет 15 секунд, оно считается доставленным и оплачивается: отчёты операторов часто опаздывают.
Что вы оплачиваете
Списывается цена только того канала, который доставил код. Попытки, которые не дошли, не оплачиваются. Актуальные цены — на странице тарифов.
Запрос кода требует, чтобы на балансе хватало на самый дорогой канал — SMS, иначе вернётся 402 insufficient_balance. Фактически спишется цена канала, который доставил код.
Суммы в API — в тиынах: поля *_tiyn, 1 ₸ = 100 тиын. Поля *_kzt — в тенге.
Пополнить баланс можно по счёту в кабинете. Дневной лимит расхода и уведомление о низком балансе настраиваются в разделе Уведомления и лимиты.