Назовите успех ответа API тем, что он подтверждает по контракту провайдера: например, создано сообщение или принято задание. Не показывайте «доставлено» только потому, что HTTP-запрос завершился без ошибки. Найдите ID сообщения и его последующий статус отдельно от ID попытки подтверждения.

У сообщения и входа разные конечные состояния

НаблюдениеЧто оно не подтверждает
Создан объект сообщенияТелефон получил SMS
Провайдер сообщает доставкуПользователь прочитал код
Код введёнПроверка завершилась успешно
Код принят серверомЛюбое другое действие автоматически разрешено

Twilio передаёт в status callback поля MessageStatus и ErrorCode и предупреждает, что порядок прихода callback не гарантирован. Источник проверен 24 октября 2026 года. Названия и смысл статусов другого сервиса сверяйте по его документации; не стройте универсальный парсер на слове success в произвольном ответе.

Сохраните соответствие внутренней попытки, challenge и ID сообщения провайдера. Если один resend создаёт новое сообщение, старая доставка остаётся событием старой отправки. Она не должна обновлять текущую попытку только по совпадению телефона. Для тестов используйте разрешённые тестовые адресаты, не рассылку по реальным клиентам.

Callback сообщает доставку, а не выдаёт сессию

Условные независимые цепочки:
message -> создано -> промежуточный статус -> итог доставки
challenge -> активен -> истёк / заменён / подтверждён
message ID -> связь с исходным challenge
поздний delivery -> обновить только допустимые сведения
успешный verify -> отдельный переход авторизации

Проверяйте подлинность callback штатным способом провайдера до изменения состояния. Twilio рекомендует методы проверки подписи из SDK с учётом изменяющегося набора параметров. Не отключайте проверку ради того, чтобы тестовый запрос начал проходить. Отдельно проверьте, что reverse proxy не меняет входные данные, используемые утверждённым механизмом валидации.

Повтор callback не должен увеличивать счётчик доставки повторно. Запоздалый промежуточный статус не должен затирать уже подтверждённый конечный исход. Но не назначайте всем статусам произвольный числовой ранг: переходы и возможности уточнения зависят от канала. Сохраняйте события и вычисляйте текущее состояние по согласованной модели.

Когда callback не пришёл, оставляйте состояние неизвестным и используйте предусмотренную провайдером сверку. Отсутствие события не доказывает недоставку. При этом получение delivery после конца срока OTP не делает код снова пригодным. Предложите безопасную новую попытку по правилам resend, не меняя задним числом TTL старого challenge.

Интерфейс должен различать ожидание и отказ

  • Показать принятую отправку без обещания доставки.
  • Отобразить предусмотренный исход недоставки.
  • Обработать повтор одного callback.
  • Получить события в обратной последовательности.
  • Доставить SMS после истечения challenge и не открыть вход.

Для наблюдаемости считайте отдельно отправки, известные конечные исходы и успешные проверки кода. Их знаменатели отличаются. Несколько SMS одной попытки не являются несколькими успешными входами, а неизвестный статус не надо автоматически записывать в доставленные ради процента.

Для расследования подготовьте обезличенные ID сообщения и попытки, время ответа API и callback, допустимые статусы и версию интеграции. Текст SMS с кодом в отчёт не добавляйте. Исправление принято, когда интерфейс честно показывает известное, а доставка никак не подменяет проверку владения кодом.

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