SMS-верификация Proton Mail: чек-лист и порядок работы для тестирования

Чек-лист перед запросом кода Proton Mail

SMS-верификация Proton Mail для тестирования проходит гладко, если сначала сделана подготовка:

• Выясните, зачем Proton просит код. Убедитесь, что на экране SMS предлагается как вариант проверки для этого шага регистрации или восстановления.
• Выберите страну осознанно. Она должна соответствовать рынку аккаунта или сценарию вашего тест-плана.
• Проверьте цену и наличие. Вызовите GET /api/v1/prices?country=<id>&service=protonmail или посмотрите в личном кабинете.
• Подготовьте приёмник. Вебхук-эндпоинт с подпиской на activation.sms_received или цикл опроса с разумным интервалом.
• Продумайте будущее почтового ящика. Если его нужно восстанавливать или проверять позже, лучше подойдёт Dedicated Number.
• Перечитайте правила. Действуют и условия Proton, и Политика допустимого использования OTP Route.

Где Proton Mail запрашивает номер телефона?

Proton Mail — почтовый сервис с упором на приватность, и телефон он использует по минимуму. Обычно это проверка на человека при регистрации: когда Proton хочет дополнительно убедиться, что новый аккаунт принадлежит реальному человеку, он может предложить SMS-код как один из нескольких вариантов. Владельцы аккаунтов могут также добавить номер как способ восстановления. Двухэтапный вход в Proton опирается на приложения-аутентификаторы или ключи безопасности, а не на SMS, поэтому номер, использованный один раз при регистрации, не нужен для последующих входов, если вы не сохранили его как телефон для восстановления.

Пошагово: API кода подтверждения Proton Mail

1. Авторизуйтесь Bearer-ключом (префикс or_live_), созданным в консоли разработчика.
2. Узнайте цену через GET /api/v1/prices?country=de&service=protonmail или с другим идентификатором страны.
3. Закажите через POST /api/v1/activations с телом {"service": "protonmail", "country": "de"}.
4. Введите полученный номер в поле проверки Proton.
5. Получите код. Ваш вебхук получает activation.sms_received; проверьте заголовок X-OTPRoute-Signature (HMAC-SHA256 от метки времени, точки и сырого тела с ключом секрета эндпоинта) и отклоняйте устаревшие метки времени. Альтернатива — опрос GET /api/v1/activations/{id}.
6. Сохраните результат по идентификатору активации, чтобы повторно доставленный вебхук обрабатывался только один раз.

Аккаунт допускает 10 API-ключей, 5 вебхук-эндпоинтов и 300 запросов в минуту. Более подробное руководство — получение OTP через вебхуки.

Пошагово: та же задача в личном кабинете

1. Войдите и откройте OTP Gateway.
2. Найдите Proton Mail и выберите страну.
3. Проверьте показанную цену и подтвердите.
4. Вставьте номер на экран SMS-проверки Proton.
5. Не закрывайте заказ: код появится рядом с номером, когда сообщение дойдёт.
6. Отмените заказ, если Proton ничего не присылает, или дождитесь конца 20-минутного окна. В обоих случаях деньги вернутся на баланс.

В каких странах можно получить номер для Proton Mail?

Маршрут Proton Mail сейчас охватывает 197 стран. Среди примеров — Швейцария, Германия, Великобритания, Бразилия, Индия, Франция, Испания, Мексика, Индонезия, Филиппины, Нигерия, Кения, Япония, Польша и США. Выбор страны важен: для теста немецкоязычного онбординга нужен немецкий номер, а аккаунт, который ведёт команда в Бразилии, выглядит убедительнее с бразильским. Актуальные варианты для любого сервиса даёт GET /api/v1/countries вместе с эндпоинтом цен.

Диагностика: SMS от Proton Mail не пришло

• Виртуальный номер отклонён. Proton может отказывать номерам, которые считает виртуальными. Выберите другой способ проверки на человека или другой маршрут; возврат покрывает попытку.
• Пока ничего нет. Дождитесь конца 20-минутного окна, а не заказывайте сразу заново: быстрые повторные заказы редко помогают.
• Загруженный маршрут. Повторите позже или выберите другую страну, которая подходит для теста.
• Вебхук молчит. Проверьте секрет эндпоинта, логику подписи и часы вашего сервера, затем сверьтесь с прямым GET /api/v1/activations/{id}.

Когда лучше выбрать Dedicated Number?

Одноразовый номер подходит для проверки регистрации. Он не годится для почтового ящика, который вашей команде придётся восстанавливать через несколько месяцев, потому что до этого номера позже не достучаться. Если аккаунту нужен рабочий телефон восстановления, например общий ящик поддержки или тестовый аккаунт для регрессионных тестов, используйте Dedicated Virtual Number в США или Канаде, от $1.95/месяц. Он остаётся у вас, пока продлевается, принимает SMS в личном кабинете и на вашем вебхуке через number.sms_received, и его можно освободить в любой момент. Подробное сравнение — одноразовые и выделенные номера.

Ответственное использование и оплата

Proton строил свой продукт вокруг приватности, и это заслуживает уважения. Используйте номера OTP Route, чтобы тестировать собственный онбординг, открывать аккаунты, которые бизнесу действительно нужны, или не выставлять личные номера сотрудников на общих логинах: один аккаунт на реального человека или компанию, с соблюдением условий Proton. Оплата — предоплаченный баланс в долларах США без ежемесячной платы, пополнение картой или USDT/USDC, PDF-счёт на каждое пополнение, а песочница доступна по запросу для работы над интеграцией. Смежные сценарии описаны на странице регистрации с приоритетом приватности.

Частые вопросы

Как получить OTP-коды Proton Mail через API?

Создайте активацию с сервисом protonmail и выбранной страной, введите номер в Proton, затем возьмите код из вебхука activation.sms_received или опросом активации.

Примет ли Proton виртуальный номер при регистрации в Proton Mail?

Не во всех случаях. Proton сам решает, каким номерам доверять, а если код не пришёл за 20 минут, деньги возвращаются автоматически.

Можно ли позже использовать тот же номер для восстановления аккаунта?

Не с одноразовым номером OTP Gateway. Для телефона восстановления, который вы сохраните, используйте Dedicated Number; он предлагается только в США и Канаде.

Использует ли Proton SMS для двухфакторного входа?

Нет. Двухэтапный вход Proton использует приложения-аутентификаторы или ключи безопасности. SMS встречается в основном при проверке на человека и как способ восстановления.

Можно ли отработать верификацию Proton Mail, не тратя средства?

Да, для работы над интеграцией: попросите поддержку перевести аккаунт разработки в песочницу, которая возвращает имитированные номера и коды. Для настоящих кодов Proton по-прежнему нужен реальный заказ.

Разрешено ли открывать несколько аккаунтов Proton таким способом?

Нет. Держите один аккаунт на реального человека или компанию и соблюдайте условия Proton; OTP Route существует для тестирования и работы ваших собственных законных аккаунтов и продуктов.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.