Тестируем регистрацию в Мозамбике, когда ни у кого в команде нет SIM-карты +258

Наш запуск в Мозамбике застрял на верификации по телефону. С чего начать?

Знакомая история: приложение переведено, экраны оплаты готовы, а последний открытый тикет требует кого-то, кто подтвердит, что клиент из Мозамбика действительно может завершить регистрацию. SIM-карты +258 ни у кого нет, роуминг оформляется долго, а личный телефон коллеги — не тестовая фикстура.

OTP Gateway снимает эту зависимость. Вы запрашиваете номер +258 для одного конкретного сервиса, используете его один раз на тестируемом экране, а входящий код возвращается к вам. Это подходит для QA и автоматизации тестирования, чек-листов запуска и команд поддержки, которые воспроизводят обращение клиента, не одалживая ничей телефон.

Как выглядит номер +258 и как его хранить?

Код страны Мозамбика — +258, национальные номера состоят из девяти цифр, и убирать магистральный ноль не нужно, поэтому локальная и международная формы отличаются только кодом страны. Мобильные номера начинаются с 8. На практике это значит:

• Сохраняйте формат E.164 — +258 и девять цифр, — а форматирование для показа делайте отдельно.
• Отклоняйте записи, в которые по привычке от других рынков добавлен ведущий ноль, или незаметно удаляйте его перед проверкой.
• Сохраняйте код страны даже для пользователей, которые всегда набирают номер только локально: он нужен вашему отправителю SMS и любому потребителю вебхуков.

Государственный язык — португальский, поэтому сообщения могут приходить на португальском или английском в зависимости от сервиса и локали аккаунта. Если ваши собственные шаблоны на португальском, проверьте, как отображаются буквы с диакритикой, например ç и ã: не-ASCII текст меняет кодировку SMS и может разбить сообщение на несколько частей.

Какие сервисы могут отправить код на номер для верификации в Мозамбике?

По всем сервисам срез для Мозамбика насчитывает более 1 600. Из часто запрашиваемых — WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, Netflix, Airbnb, Discord и Claude.

Доступность динамическая, а не фиксированная: один и тот же сервис в один час может быть хорошо представлен, а позже — нет. Узнавайте её через API или в кабинете перед каждым заказом, а не зашивайте список в тест-план.

Как работает поток OTP API для Мозамбика от начала до конца?

Для разработчиков интеграция — это короткая последовательность вызовов к https://otproute.com/api/v1, подписанных Bearer-ключом с префиксом or_live_:

1. Определите идентификатор Мозамбика (mz) и идентификатор сервиса через GET /api/v1/countries и GET /api/v1/services.
2. Проверьте GET /api/v1/prices?country=mz&service=<id>: там актуальная цена и информация о наличии номеров.
3. Отправьте POST /api/v1/activations с {"service": "telegram", "country": "mz"} и сохраните возвращённые идентификатор активации и номер.
4. Заберите код, когда activation.sms_received придёт на ваш эндпоинт, или запрашивайте GET /api/v1/activations/{id} раз в несколько секунд.
5. Вызовите POST /api/v1/activations/{id}/cancel, если тест прекращён.

Запросы вебхука содержат заголовок X-OTPRoute-Signature (t=<unix>,v1=<hex>) — HMAC-SHA256 от <t>.<raw body> с секретом вашего эндпоинта. Проверяйте его, отклоняйте старые метки времени и делайте обработчик идемпотентным по идентификатору активации. Ключи создаются в консоли разработчика (до 10, плюс 5 вебхук-эндпоинтов), лимит — 300 запросов в минуту. Руководство по интеграции OTP API показывает тот же поток API SMS-верификации с обработкой ошибок.

Может ли не разработчик заказать номер +258 в личном кабинете?

Да, и это использует ту же маршрутизацию OTP, что и API. После того как вы создали аккаунт по электронной почте и 6-значному коду (или через Google), пополните баланс, откройте OTP Gateway, выберите Мозамбик и сервис и подтвердите показанную цену. Номер появляется сразу; вставьте его в приложение, и когда код придёт, он отобразится на той же странице. Для самого аккаунта доступен двухфакторный вход через приложение-аутентификатор.

Почему не пришёл код и что попробовать дальше?

У каждой активации есть окно в 20 минут. Если оно закрылось без SMS или вы отменили заказ, вся сумма автоматически возвращается на кошелёк; вы платите, только когда код пришёл.

Если прогон раз за разом остаётся пустым:

• Дайте окну время. Как быстро придёт код, зависит от сервиса и маршрута.
• Проверьте, принимает ли этот сервис виртуальные номера: некоторые отклоняют их сразу.
• Повторите после паузы или выберите другой маршрут, если тесту не нужен именно номер Мозамбика.
• Делайте паузы между попытками, а не бомбардируйте эндпоинт заказов, и записывайте идентификатор каждой активации, чтобы сравнивать неудачи.

Есть ли постоянная линия в Мозамбике и как она оплачивается?

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

Оплата идёт с одного предоплаченного кошелька в USD по факту использования, без подписки. Принимается пополнение картой и стейблкоинами USDT/USDC, после каждого приходит PDF-счёт по электронной почте. Для разработки и отладки тестовый аккаунт по запросу можно перевести в режим песочницы: тогда симулированные номера и коды проходят через ваш код без каких-либо затрат. О том, как показываются тарифы, — на странице цен.

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

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

Да. Номер +258 приходит из OTP Gateway, поэтому ваша команда может провести тест откуда угодно и прочитать код в кабинете или через API.

Какой идентификатор страны у Мозамбика в API?

Используйте mz в GET /api/v1/prices и в теле POST /api/v1/activations.

Нужен ли мозамбикским номерам ведущий ноль?

Нет. В Мозамбике нет внутреннего магистрального префикса, поэтому хранимая форма — просто +258 и девять цифр.

Сколько стоит получение SMS с OTP из Мозамбика?

Коды стоят от $0.20 за код, а точная цена для каждого сервиса возвращается API в реальном времени и показывается в кабинете до заказа.

Будет ли тестовый номер +258 работать для входа на следующей неделе?

Не рассчитывайте на это. Номер OTP Gateway предназначен для одного кода, а долгосрочные выделенные номера предлагаются только в США и Канаде.

Есть ли правила о том, что можно верифицировать этими номерами?

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

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