Когда пользователь говорит «код пришёл через пять минут», не увеличивайте таймер вслепую. Найдите provider message ID и постройте линию времени. Если запрос две минуты лежал в вашей очереди — виноват не оператор. Если провайдер быстро поставил статус `sent`, но `delivered` появился позже, задержка уже после передачи сообщения дальше.

Статус `sent` не означает, что телефон показал SMS: у провайдера он обычно фиксирует передачу вышестоящему оператору. Для точного вывода нужны delivery receipts, а их доступность и смысл зависят от канала и страны.

Пять временных меток вместо одного таймера

МеткаКто ставитЧто показывает
challenge_created_atваше приложениес какого момента код действителен
provider_requested_atваш senderкогда запрос ушёл наружу
queued_atпровайдерпринят в очередь
sent_atпровайдерпередан следующему участнику
delivered_atdelivery receiptподтверждена доставка, если поддерживается

Все метки храните в UTC, а в интерфейсе переводите для человека. Рядом нужны challenge id, provider message id, channel и обезличенный destination hash. Сам код и полный телефон в диагностический лог не записывают.

Срок жизни относится к challenge, а не к SMS

Одноразовый код — это серверный challenge. Его срок действия начинается по вашему правилу, обычно при создании или выдаче, и проверяется на сервере. Начинать TTL с неизвестного момента доставки нельзя: callback может опоздать, не прийти или быть недоступен. Увеличение TTL повышает окно для перебора и не устраняет очередь.

challenge: id, user_key, code_hash, created_at, expires_at, attempts, state
message:   provider_id, challenge_id, queued_at, sent_at, delivered_at, status

verify only when:
  challenge.state = 'active'
  now < expires_at
  attempts < policy_limit

Повторная отправка не должна оживлять старый код

Выберите понятную модель. Самая простая: новый запрос закрывает прежний challenge, а принимается только последний код. Если бизнес требует один и тот же код в нескольких сообщениях, сохраняйте один challenge и не продлевайте `expires_at` каждым нажатием. Иначе злоумышленник сможет удерживать код активным повторными отправками.

  • Показать cooldown до новой отправки и не запускать параллельные сообщения.
  • После resend сообщить, что прежний код больше не действует, если это ваша модель.
  • Ограничить запросы по аккаунту, сессии и доверенному сетевому сигналу.
  • Ограничить число попыток проверки отдельно от числа отправок.
  • Не раскрывать, существует ли аккаунт, разными ответами endpoint.

Статусы превращаются в разные действия поддержки

НаблюдениеВероятный участокДействие
created → requested долговнутренняя очередьпроверить worker и retry
queued долгоочередь провайдераметрики маршрута/лимита
sent без deliveredоператор/устройстводругой канал по политике
undelivered/failedошибка адреса или маршрутапоказать безопасный вариант
delivered быстро, увидел поздноустройство/UXне обещать точное SMS-время

Outbound status callbacks обрабатывайте идемпотентно и проверяйте подлинность запроса способом, который документирует ваш провайдер. Callback может прийти повторно или позже, чем пользователь уже завершил вход; он обновляет телеметрию, но не должен снова активировать закрытый challenge.

Интерфейс не обещает невозможного

После нажатия пишите «запрос принят», а не «код доставлен». Покажите маскированный адрес, оставшееся время challenge и понятный момент доступности resend. После устойчивой ошибки предложите резервный подтверждённый канал — например, authenticator или recovery flow — вместо бесконечной серии SMS.

Контрольный тест искусственно задерживает каждый участок

  1. Создать challenge и задержать внутренний sender на минуту.
  2. Убедиться, что метрика показывает задержку до provider request.
  3. Отправить два запроса и проверить политику старого кода.
  4. Подать повторный и переставленный callback одного message id.
  5. Проверить отказ после expires_at и лимита попыток.
  6. Смоделировать failed/undelivered и переход к резервному каналу.

Проблема решена, когда для каждого медленного сообщения виден участок задержки, старый OTP не принимается вопреки политике, а повторные callbacks не меняют результат входа. Для анализа нужны challenge id, message id, статусы и метки времени — коды, tokens и полный номер телефона не нужны.

Проверенные источники