Номера Гватемалы (+502) для верификации: тестирование и операционная работа

Почему Гватемала заслуживает отдельного тестового прогона?

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

Регулярно встречаются три ситуации:

• Региональные запуски, где экран ввода телефона, испанские формулировки SMS и шаг верификации нужно проверить на настоящем маршруте +502 (верификация мобильных приложений).
• Продукты для диаспоры, например приложения для денежных переводов или звонков, которыми пользуются гватемальцы в США, где аккаунт привязан к номеру на родине.
• Операционные команды, которые ведут бизнес-профили гватемальских клиентов, не желающих связывать с ними чей-либо личный телефон (операционные команды).

Как форматируются телефонные номера Гватемалы?

В Гватемале национальные номера состоят из восьми цифр, и префикса внутренней сети нет, поэтому убирать ведущий ноль не нужно. Форма E.164 — это просто +502 и эти восемь цифр, запись +502 xxxx xxxx.

Такая короткая длина подводит валидаторы форм, написанные в расчёте на десятизначные североамериканские номера. Добавьте тестовые случаи для ввода из восьми цифр, для пользователей, которые вводят 502 без знака плюс, и для пробелов или дефисов посередине. Храните нормализованную строку E.164 и не пытайтесь определять, мобильный номер или стационарный, только по длине, ведь у обоих по восемь цифр.

Можно ли получать SMS OTP-коды Гватемалы через API?

Да. OTP API для Гватемалы использует идентификатор страны gt с базовым адресом https://otproute.com/api/v1 и авторизацией Bearer-ключом с префиксом or_live_.

Начните с GET /api/v1/services, чтобы найти идентификатор сервиса, затем проверьте текущую цену через GET /api/v1/prices?country=gt&service=<id>. Создайте номер через POST /api/v1/activations с телом {"service": "<id>", "country": "gt"}. Когда ваше приложение отправит SMS, либо опрашивайте GET /api/v1/activations/{id}, либо пусть endpoint вебхука получит activation.sms_received. Проверяйте заголовок X-OTPRoute-Signature — HMAC-SHA256 от метки времени и сырого тела — и отклоняйте устаревшие метки времени, как описано в материале о защите вебхуков OTP. Лимиты перечислены в обзоре для разработчиков: 10 ключей, 5 вебхук-endpoint-ов, 300 запросов в минуту.

Какие сервисы сейчас доступны на маршруте +502?

Для Гватемалы указано более 1,600 сервисов. В текущем срезе среди популярных — WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), X (Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix и Microsoft & Outlook. Наличие меняется в течение дня, поэтому API возвращает актуальную доступность, а не фиксированный каталог.

Есть ли путь без кода для сотрудников поддержки и операционных отделов?

Любой член команды может заказывать из личного кабинета после того, как вы зарегистрируетесь по email и 6-значному коду или через вход с Google. Выберите Гватемалу, выберите сервис, подтвердите показанную цену и скопируйте номер +502 в приложение. Код появится на том же экране, когда придёт. Включить двухфакторную защиту (TOTP) для самого аккаунта OTP Route — разумный шаг при общем доступе команды.

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

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

1. Дождитесь конца окна; время доставки зависит от сервиса и маршрута.
2. Повторите позже или через другой маршрут сервиса, если он предлагается.
3. Убедитесь, что сервис принимает виртуальные номера, так как некоторые их отклоняют.
4. Не отправляйте новые заказы в плотном цикле; делайте паузы между попытками.

Что насчёт долгосрочных гватемальских номеров, оплаты и песочницы?

Самостоятельно оформляемого долгосрочного номера Гватемалы в OTP Route нет. Выделенные линии есть только для США и Канады, от $1.95/month. Если вам нужна постоянная линия +502, напишите на [email protected]; возможность что-либо организовать зависит от местных правил и не гарантируется.

Оплата идёт через один предоплаченный кошелёк в долларах США без тарифного плана и ежемесячной платы, пополняемый картой или в USDT/USDC, при этом за каждое пополнение на email приходит PDF-счёт. Для интеграционной работы тестовый аккаунт по запросу можно перевести в песочницу, чтобы симулированные номера и коды проходили через ваш код бесплатно.

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

Можно ли проверить нашу испаноязычную регистрацию для Гватемалы без местной SIM-карты?

Да. Закажите номер gt в OTP Gateway, введите его в приложении и прочитайте испанский код в личном кабинете или на своём вебхуке.

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

Нет. В Гватемале нет префикса внутренней сети, поэтому номер — это просто +502 и восемь цифр.

Какова минимальная стоимость кода +502?

Цены начинаются от $0.20 за код; сумму для конкретного сервиса возвращает GET /api/v1/prices, и она показывается до подтверждения.

Спишут ли деньги, если проверочное SMS так и не придёт?

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

Может ли OTP Route закрепить один и тот же номер +502 за моей командой надолго?

Самостоятельно — нет. Номера OTP Gateway рассчитаны на один код, а долгосрочные линии есть только в США и Канаде, поэтому по Гватемале спросите [email protected].

Какие правила действуют при использовании этих номеров?

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

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