WhatsApp OTP в Казахстане

Три запроса: отправить, проверить, узнать статус

• POST /api/v1/otp/send — создать код для номера получателя. Срок действия можно задать от одной до десяти минут.
• POST /api/v1/otp/verify — проверить код, который ввёл пользователь. После успешной проверки код больше не принимается.
• GET /api/v1/otp/{id} — узнать состояние запроса, доставки и проверки.

Примеры для Node.js, PHP и Python можно адаптировать под ваш сайт или приложение. Все методы используют API v1.

Отдельный доступ для каждого проекта

Создайте отдельные проекты для сайта, приложения и тестовой среды. У каждого проекта свои API-ключи, статистика и вебхук. Ключ можно отозвать, а проект — приостановить.

Вебхуки сообщают об отправке, доставке, прочтении, успешной проверке и ошибке. Доставка сообщения сама по себе не подтверждает личность: вход разрешайте только после успешного ответа метода verify.

Повторные запросы и защита кода

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

При сетевой ошибке повторяйте запрос с тем же Idempotency-Key. Так повтор вашего запроса не превратится в ещё одну отправку.

Тестовый режим и реальные отправки

Sandbox возвращает тестовый код и ничего не отправляет в WhatsApp. Он подходит для проверки формы входа, срока действия и обработки ошибок.

Реальные отправки требуют активного live-проекта, готового отправителя WAIX и оплаченного пакета для страны получателя. Доступные страны, пакеты и цены показаны в кабинете. Если пакет ещё не опубликован, можно продолжать разработку в sandbox и уточнить запуск у поддержки.

Пакет действует месяц. Когда лимит исчерпан, отправка останавливается; автоматических списаний сверх пакета нет. Условия продления и итоговая цена видны перед оплатой.