Рабочий чек-лист для тестирования и работы с OTP в Гане (+233)

Перед началом: список готовности для Ганы

Отметьте эти пункты, и тест с +233 редко преподнесёт сюрпризы:

1. Учётные данные. Bearer-ключ из консоли разработчика (префикс or_live_). Отдельные ключи для локальной среды, staging и CI упрощают отзыв.
2. Идентификаторы страны и сервиса. Гана — gh; идентификаторы сервисов берутся из GET /api/v1/services.
3. Парсер номеров, понимающий нуль внутренней сети. Дома жители Ганы пишут мобильные номера с ведущим 0, и ваши формы будут получать оба варианта.
4. Доставка кода. Либо цикл опроса, либо endpoint вебхука с надёжно хранимым секретом.
5. Короткий список сервисов для покрытия. До заказа решите, каким сценариям регистрации и входа нужен ганский номер.
6. Контроль бюджета. Перед пакетом вызовите GET /api/v1/balance, чтобы не остановиться посреди набора тестов.

Как записываются ганские мобильные номера и как их хранить?

Код страны Ганы — +233, префикс внутренней сети — 0. Мобильный номер в местной записи состоит из десяти цифр и начинается с 0; в международной форме 0 исчезает, и после +233 идут девять цифр. Классическая ошибка качества данных: пользователь выбирает +233, а затем вводит местный номер вместе с нулём, из-за чего появляется лишняя цифра. Отбрасывайте один ведущий 0, если указан код страны, затем сохраняйте результат в E.164, чтобы дедупликация, поиск и отправка SMS работали с единым представлением.

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

Зачем тестировать здесь? Командам, запускающимся в Западной Африке, продуктам, построенным вокруг мобильных денег и платежей, и компаниям, обслуживающим ганскую диаспору в Великобритании и Северной Америке, нужно подтверждение, что регистрация по номерам +233 работает. Fintech-команды могут прочитать наши заметки об онбординге в fintech, где рассказано о стороне KYC.

Заказ номера +233 через API SMS-верификации

Базовый адрес — https://otproute.com/api/v1.

1. Получите актуальную цену для вашей пары через GET /api/v1/prices?country=gh&service=<id>; ответ также показывает, доступен ли маршрут сейчас.
2. Отправьте POST /api/v1/activations с {"service": "<id>", "country": "gh"} и сохраните возвращённый идентификатор активации рядом с тест-кейсом.
3. Передайте номер +233 тестируемому продукту.
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 от метки времени, точки и сырого тела с секретом endpoint-а, сравнивайте за постоянное время и отклоняйте устаревшие метки времени. Сделайте обработчик идемпотентным, привязав его к идентификатору активации, чтобы повторная доставка не заполнила один и тот же тест дважды. В центре разработчиков есть примеры SDK и справочник.

Какие сервисы сейчас маршрутизируются через Гану?

На маршруте Ганы доступно более 1,600 сервисов. В текущем срезе среди популярных — WhatsApp, Telegram, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), LinkedIn, Uber, Amazon, ChatGPT (OpenAI), Claude, Discord и Signal. Среди того, на что регистрируются жители Ганы, преобладают соцсети и мессенджеры, поэтому они — естественный первый проход для QA локализации.

Доступность меняется в реальном времени, а не фиксирована. Запрашивайте endpoint цен для конкретной пары, а не доверяйте списку, который был верен сегодня утром.

Работа из личного кабинета вместо API

Не всем в команде нужен код. Войдите, откройте OTP Gateway, выберите Гану и сервис, посмотрите цену, которая отображается перед заказом, и подтвердите. Скопируйте номер +233 в тестируемое приложение; когда SMS придёт, код отобразится рядом с заказом вместе с оставшимся временем. Сотрудники операционных отделов часто используют этот путь, чтобы проверить один сценарий после релиза, не трогая тестовую обвязку.

Диагностика молчащего номера +233

Если ничего не появляется, пройдите по списку по порядку:

• Окно ещё открыто? Активации длятся 20 минут. Дайте сервису время, прежде чем делать вывод о сбое.
• Принял ли сервис номер? Некоторые платформы отклоняют виртуальные номера. Ошибка в самой форме означает: отмените заказ и попробуйте другой маршрут.
• Повторите позже или по другому маршруту. Покрытие для конкретного сервиса меняется в течение дня.
• Не долбите запросами. Цикл, который перезаказывает номер каждые несколько секунд, расходует лимит в 300 запросов в минуту и редко помогает.
• Загляните в собственные логи. Отклонённая подпись или упавший обработчик выглядят как пропавший код.

Деньги списываются, только если код пришёл. Истёкшие и отменённые активации возвращаются в кошелёк полностью и автоматически. В нашей статье о снижении числа недоставленных OTP подробнее разобрано проектирование повторов.

Долгосрочные линии, оплата и песочница

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

OTP Route использует один предоплаченный кошелёк в долларах США, оплата по мере использования, без подписки. Пополняйте его картой или в USDT/USDC, и каждый раз на email приходит PDF-счёт. Для интеграционных работ тестовый аккаунт по запросу можно перевести в песочницу, которая возвращает симулированные номера и коды. Вы можете создать аккаунт с кодом по email или через вход с Google. Используйте каждый номер в соответствии с условиями целевого сервиса и нашей Политикой допустимого использования.

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

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

Да. Создайте активацию со страной gh и получайте код по вебхуку или опросом endpoint-а активации.

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

Нет. Отбросьте внутренний 0 и храните E.164 с +233 и девятью цифрами — так поиск и дедупликация остаются согласованными.

На каком языке приходят проверочные тексты на ганские номера?

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

Сколько стоит номер +233 для тестирования?

Коды OTP Gateway стоят от $0.20 за код; точная сумма для сервиса показывается до заказа.

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

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

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

Самостоятельно — нет. Долгосрочные линии существуют только в США и Канаде; о других странах спросите команду по email.

Можно ли платить стейблкоинами?

Да. Кошелёк принимает пополнение картой, а также USDT и USDC, и к каждому пополнению прилагается PDF-счёт.

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