Номера верификации Великобритании: чек-лист тестирования OTP на +44

Чек-лист: готов ли ваш стек к кодам подтверждения +44?

Пройдите по этому списку, прежде чем релиз-кандидат дойдёт до британской части тест-плана:

• [ ] Ключ из консоли разработчика (префикс or_live_), выделенный под задачу, которая будет его использовать.
• [ ] Id страны Великобритании, gb, подключён в ваши фикстуры, а также id сервиса из GET /api/v1/services.
• [ ] Решение по доставке: подписанный вебхук для параллельных наборов или опрос для быстрого скрипта.
• [ ] Разбор номеров, учитывающий британский ведущий ноль (подробнее ниже).
• [ ] Достаточный баланс, подтверждённый через GET /api/v1/balance, или аккаунт в песочнице для пробных прогонов.
• [ ] Заметка в ранбуке о том, что один номер обслуживает ровно один код.

Командам, встраивающим это в пайплайны, пригодится материал про тестирование SMS OTP в CI-пайплайнах.

Как работает поток OTP API Великобритании для id страны gb?

Последовательность повторяет то, что делает тестировщик вручную, только быстрее и с журналом:

1. Узнайте цену пары через GET /api/v1/prices?country=gb&service=<id>; ответ отражает актуальную доступность.
2. Зарезервируйте номер через POST /api/v1/activations с телом {"service": "<id>", "country": "gb"}.
3. Введите номер +44 на экране регистрации, входа или восстановления и запросите SMS.
4. Получите код через событие activation.sms_received или прочитав GET /api/v1/activations/{id}.
5. Корректно прервите заказ через POST /api/v1/activations/{id}/cancel, если тест пропущен.

Обработчик вебхука должен считать любой запрос недоверенным, пока не пройдёт проверка заголовка X-OTPRoute-Signature: HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта должен совпасть с v1, а метка времени должна быть свежей. Сохраняйте результаты по id активации, чтобы дубликаты доставки были безвредны. Для большинства наборов лимиты щедрые: 300 запросов в минуту, до 10 ключей и 5 вебхук-эндпоинтов на аккаунт. Полный справочник — в документации для разработчиков.

Какие британские сервисы и приложения есть на маршруте?

Великобритания — один из самых широких маршрутов, доступно более 4 000 сервисов. Популярные варианты — WhatsApp, Google (Gmail & YouTube), Amazon, Uber, Netflix, eBay, Airbnb, LinkedIn, Microsoft & Outlook, Instagram, Snapchat, X (Twitter), Discord и ChatGPT (OpenAI).

Маршруты меняются от часа к часу, поэтому пусть эндпоинт цен или панель сообщают, что можно заказать сейчас, вместо того чтобы считать вчерашний результат актуальным.

Ведущий ноль: как хранить британские мобильные номера в E.164

В Великобритании используется транковый префикс 0. Люди пишут свой мобильный как 07xxx xxxxxx, одиннадцать цифр, но в международном виде 0 исчезает, и номер становится +447xxxxxxxxx. Самая частая ошибка в британских полях телефона — сохранить оба, что даёт недействительную строку +4407…, на которую не доставит ни один SMS-шлюз.

Какие проверки стоит добавить в тестовый набор:

• Ввод 07… нормализуется в +447… до сохранения.
• Ввод, уже имеющий вид +44 7…, проходит без изменений.
• Пробелы в привычной группировке 07xxx xxxxxx удаляются.
• Форматирование для показа применяется только на выводе и никогда не сохраняется.

Проверочные сообщения для британских пользователей приходят на английском. В Уэльсе официальным языком является также валлийский, поэтому публичным сервисам с двуязычным интерфейсом стоит проверить, что шаблоны и экраны корректно работают на обоих.

Почему команды QA и роста тестируют британские номера

Для многих компаний Великобритания — это либо домашний рынок, либо первый за его пределами. Финансовые продукты особенно часто ставят телефонную верификацию в центр онбординга и дополнительных проверок, поэтому сломанный поток +44 быстро заметен по обращениям в поддержку.

Частые причины заказать номер +44 для тестов:

• Запуск в Великобритании, когда сборке en-GB нужен отдельный прогон на орфографию, форматы дат и список стран.
• Регрессионные тесты входа и восстановления доступа после изменения настроек вашего SMS-провайдера.
• Воспроизведение неудачной регистрации британского клиента, чтобы увидеть, где потерялся код.

На странице про онбординг в финтехе описано, как команды выстраивают такие проверки.

Что делать, если код на +44 не пришёл

Когда код не приходит, не спешите заказывать заново. Вместо этого:

1. Дождитесь окончания 20-минутного окна: некоторые сервисы удерживают сообщения на короткое время.
2. Проверьте статус активации. Если она завершилась как истёкшая, значит, ничего не пришло и вся сумма уже вернулась на кошелёк.
3. Помните, что некоторые сервисы отклоняют виртуальные номера. Именно такой исход покрывает правило возврата.
4. Повторите после паузы или через другой маршрут для того же сервиса, а не крутите заказы в цикле.
5. Убедитесь, что ваше приложение вообще запросило SMS и отправило его на зарезервированный номер +44, а не на устаревшую фикстуру.

Панель, оплата и долгосрочные британские линии

Нетехнические сотрудники могут сделать всё это без кода: откройте панель, выберите Великобританию и сервис, подтвердите показанную цену, скопируйте номер в приложение и ждите код на той же странице.

Самообслуживаемого долгосрочного британского номера нет. Dedicated Numbers (выделенные номера) — продукт для США и Канады, от $1.95/месяц; для постоянной британской линии напишите на [email protected], и команда объяснит, что допускают местные правила, не давая обещаний. Всё работает на предоплаченном кошельке в долларах США без абонентской платы: пополнение картой или в USDT/USDC, PDF-счета по почте. Подробности — на странице тарифов.

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

Можно ли протестировать регистрацию в Великобритании без британской SIM-карты?

Да. Запросите номер +44 в OTP Gateway, введите его на экране регистрации и прочитайте код в панели, из вебхука или через эндпоинт активации.

Id страны Великобритании в API — `uk` или `gb`?

Это gb, по коду страны ISO.

Как преобразовать британский номер, начинающийся с 07?

Отбросьте ведущий 0 и добавьте +44: 07… превращается в +447….

Плачу ли я за британскую активацию, которая истекла?

Нет. Если SMS не пришло за 20 минут или вы отменили активацию, вся сумма автоматически возвращается на кошелёк.

Может ли OTP Route дать мне британский номер на несколько месяцев?

Как самообслуживаемый продукт — нет. Долгосрочные Dedicated Numbers продаются только для США и Канады; можно написать в поддержку по поводу Великобритании, без гарантии, что это возможно.

Можно ли сначала опробовать британскую интеграцию в песочнице?

Да. Тестовый аккаунт можно перевести в режим песочницы по запросу: он возвращает имитированные номера и коды, поэтому тестировать можно без трат с кошелька.

Какие правила действуют для британских номеров верификации?

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

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