Тестируем регистрацию в Белизе, когда ни у кого в команде нет SIM-карты +501

Релизу нужен код на +501, но ни у кого нет белизской SIM-карты

Ситуация знакомая: запланирован запуск в Центральной Америке, в плане QA значится Белиз, а белизские телефоны есть только у клиентов. Брать личный номер коллеги неловко, и такой способ плохо повторяется от цикла к циклу тестирования.

OTP Route решает именно эту узкую часть задачи. OTP Gateway выдаёт номер +501 для одного кода подтверждения в выбранном сервисе и затем передаёт вам этот код. Это OTP-маршрутизация для команд, которые проверяют собственные экраны регистрации и входа, и она хорошо вписывается в процесс QA-тестирования.

Почему белизские номера легко обработать неправильно?

Номера Белиза короткие. После кода страны +501 идёт семизначный национальный номер, а префикса для внутренних звонков нет, поэтому внутренняя запись и формат E.164 отличаются только ведущим +501. Валидаторы, написанные под ведущий 0 или десятизначный национальный номер, нередко отвергают корректный белизский ввод — для этого стоит завести отдельный тест-кейс.

Храните номер как +501 и семь цифр, перед сохранением удаляйте символы форматирования, а местную группировку цифр показывайте только в интерфейсе. Официальный язык — английский, при этом широко распространены испанский и белизский креольский. Проверочные SMS обычно приходят на английском, хотя возможен и испанский шаблон, поэтому извлекайте код по шаблону из цифр.

Белиз — единственная страна Центральной Америки, где английский является официальным языком, поэтому он удобен как контрольная точка, когда команда локализует один сценарий сразу на английский и испанский для региона.

Как получить белизский номер для верификации через API?

Каждый запрос к https://otproute.com/api/v1 авторизуйте Bearer-ключом с префиксом or_live_, созданным в консоли разработчика.

1. Получите каталог через GET /api/v1/services и GET /api/v1/countries; Белиз — это bz.
2. Проверьте актуальную цену и доступность: GET /api/v1/prices?country=bz&service=<id>.
3. Оформите заказ через POST /api/v1/activations с телом {"service": "whatsapp", "country": "bz"}.
4. Передайте полученный номер +501 в ваше приложение.
5. Ждите activation.sms_received на подписанном вебхуке или опрашивайте GET /api/v1/activations/{id}. Досрочно отменить можно через POST /api/v1/activations/{id}/cancel.

Запросы вебхука содержат заголовок X-OTPRoute-Signature; проверьте HMAC-SHA256 от <t>.<raw body> и отклоняйте устаревшие метки времени. Подробности запросов и ответов описаны в документации для разработчиков.

Какие приложения могут отправлять коды на номер +501?

Сейчас на белизских маршрутах доступно более 900 сервисов. Среди самых востребованных: WhatsApp, Facebook, Google (Gmail & YouTube), Airbnb, Instagram, TikTok, Telegram, Uber, Amazon, eBay, Microsoft & Outlook, Signal и Snapchat.

Доступность меняется в течение дня, поэтому воспринимайте этот список как срез и узнавайте, что доступно прямо сейчас, через эндпоинт цен или в панели.

Не хотите писать код? Используйте панель

Сотрудникам поддержки и менеджерам продукта API вообще не нужен. Войдите, выберите сервис, укажите Белиз, проверьте цену и подтвердите заказ. Номер +501 появится на экране; вставьте его в проверяемое приложение, и код отобразится рядом с заказом, когда придёт. Кнопка отмены завершает заказ досрочно и возвращает деньги.

Код опаздывает или не приходит: что делать?

Время доставки зависит от сервиса и маршрута, а не от того, что вы можете настроить. Если код не пришёл:

• Не закрывайте заказ: окно длится 20 минут, а истёкший или отменённый заказ возвращается полностью.
• Повторите после паузы или с другим маршрутом сервиса, если тест это допускает.
• Проверьте, принимает ли сервис виртуальные номера на этом шаге. Некоторые их отвергают, и этот случай покрывает возврат.
• Не засыпайте эндпоинт заказа запросами в цикле; в автоматических заданиях делайте паузы между повторами.

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

Самостоятельно оформить долгосрочный номер Белиза нельзя. Dedicated Numbers от $1.95 в месяц существуют только для США и Канады; если вашей команде нужна постоянная белизская линия, напишите на [email protected], помня, что доступность зависит от местных правил. Сравнение в материале временные и выделенные номера объясняет, когда подходит каждый вариант.

Оплата — предоплаченный кошелёк в долларах США, по мере использования, без ежемесячной платы. Пополняйте его картой или USDT/USDC и получайте PDF-счёт на почту за каждое пополнение. Попросите поддержку перевести тестовый аккаунт в песочницу, и API будет выдавать имитированные номера +501 и коды, чтобы CI мог проверить весь путь бесплатно. Зарегистрироваться можно по почте и 6-значному коду или через Google.

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

Можно ли получать SMS-коды Белиза, не находясь в Белизе?

Да. Номер +501 выдаёт OTP Gateway, а код вы читаете в панели или через API из любой точки, где работает ваша команда.

Сколько цифр в телефонном номере Белиза?

Национальный номер состоит из семи цифр без префикса для внутренних звонков; в международном формате он записывается как +501 и эти семь цифр.

Какой идентификатор страны для Белиза в API OTP Route?

Используйте bz в вызовах вроде POST /api/v1/activations.

Что будет с моими деньгами, если код из Белиза не придёт?

Ничего не удерживается. Когда 20-минутное окно закрывается без SMS или вы отменяете заказ, вся сумма возвращается на кошелёк.

Подходит ли номер Белиза для аккаунта, в который я вхожу каждую неделю?

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

Есть ли ограничения на то, что можно проверять номером +501?

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

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