Практическое руководство по номерам +220 для верификации в Гамбии

Что инженерам нужно знать о гамбийском плане нумерации?

Код Гамбии — +220, префикса внутренней сети (trunk prefix) нет, поэтому локальная и международная формы номера различаются только кодом страны. Абонентские номера состоят из семи цифр, так что полная строка E.164 — это +220 и семь цифр.

Несколько привычек помогут сохранить данные чистыми:

• Храните в таблице пользователей только каноническую форму E.164.
• Убирайте пробелы и дефисы при вводе, но не отбрасывайте ведущие цифры: убирать нечего, нуля здесь нет.
• Сделайте список стран доступным для поиска и по «Gambia», и по «The Gambia»: пользователи вводят оба варианта, а список, который находит только один, — это тикет в поддержку, который ещё не создан.

Страна почти полностью окружена Сенегалом, поэтому проверьте, что геолокация или значения по умолчанию на основе IP не подставляют +221 гамбийским посетителям.

На каком языке приходят гамбийские OTP-сообщения и почему важна кодировка?

Официальный язык — английский, поэтому большинство проверочных текстов от глобальных приложений приходит на английском. В повседневной жизни широко распространены волоф, мандинка и фула. Если ваш продукт локализует SMS-шаблоны на волоф, следите за кодировкой: такие буквы, как ë, не входят в алфавит GSM-7, из-за чего всё сообщение переходит в UCS-2, а длина сегмента сокращается со 160 до 70 символов. Длинный локализованный шаблон может разбиться на несколько частей, поэтому размещайте код ближе к началу сообщения, чтобы он пережил любое усечение.

Зачем продуктовым командам тестировать или работать в Гамбии?

Рынок небольшой, но сценарии вполне конкретные. Приложения для денежных переводов и fintech обслуживают многочисленную диаспору в Великобритании, США и континентальной Европе, и им нужно доказать, что отправитель за границей может подключить получателя с номером +220. Туристический бизнес на атлантическом побережье подтверждает гостей и сотрудников. Региональные продукты, выходящие на рынки Западной Африки, часто тестируют Гамбию вместе с Сенегалом, потому что у этих двух рынков много общих пользователей.

Номер +220 для тестирования подтверждает весь путь: ваша форма его принимает, ваш провайдер маршрутизирует на него, а код читается человеком на другом конце. На странице QA-тестирования описано, как команды включают это в проверки перед релизом.

Какие сервисы сейчас присылают коды на номера +220?

Маршрут Гамбии включает более 1,000 сервисов. В актуальном срезе есть WhatsApp, Facebook, Telegram, Google (Gmail & YouTube), Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Signal и imo.

Наличие номеров меняется в течение дня, поэтому считайте список ориентировочным и перед каждым запуском проверяйте маршрут для gm, а не зашивайте предположения в набор тестов.

Как получать SMS OTP-коды Гамбии через API?

Авторизуйтесь Bearer-ключом с префиксом or_live_ на https://otproute.com/api/v1. Сначала вызовите GET /api/v1/prices?country=gm&service=whatsapp, чтобы узнать, открыта ли эта пара и сколько она стоит. Затем создайте активацию через POST /api/v1/activations с телом {"service": "whatsapp", "country": "gm"}; в ответе придут номер и идентификатор активации, который стоит записать в лог рядом с тест-кейсом.

Когда ваш сценарий отправит SMS, на ваш endpoint сработает вебхук activation.sms_received. Проверьте заголовок X-OTPRoute-Signature (HMAC-SHA256 от метки времени, точки и сырого тела запроса с секретом endpoint-а) и отбрасывайте запросы со старыми метками времени. Если не хотите открывать endpoint, опрашивайте GET /api/v1/activations/{id}. Неиспользованные активации отменяйте через POST /api/v1/activations/{id}/cancel. Лимиты: 300 запросов в минуту, 10 ключей и 5 вебхук-endpoint-ов на аккаунт; подробнее об этом потоке OTP API для Гамбии — на странице для разработчиков и в руководстве по приёму через вебхуки.

Те, кто не работает с кодом, могут сделать то же самое в личном кабинете: откройте OTP Gateway, выберите Гамбию и сервис, подтвердите цену, закажите номер и наблюдайте, как код появляется в активации.

Что делать, если код не приходит на номер +220?

Окно активации — 20 минут. Если SMS не пришло за это время или вы отменили заказ, вся сумма автоматически возвращается в кошелёк, так что пропущенный код ничего не стоит.

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

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

OTP Route не предлагает самостоятельно оформляемый долгосрочный номер в Гамбии. Dedicated Numbers, которые остаются за вами, пока продлеваются, существуют только для США и Канады и стоят от $1.95/month. Для постоянной линии +220 напишите на [email protected]; возможность организовать её зависит от местных правил.

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

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

Можно ли проверить онбординг +220 в моём fintech-приложении, не летя в Банжул?

Да. Закажите номер для верификации Гамбии в OTP Gateway, запустите онбординг и прочитайте код в личном кабинете или через API.

Какое значение кода страны для Гамбии использовать в запросах API?

gm; оно используется и в GET /api/v1/prices, и в POST /api/v1/activations.

Сколько цифр в гамбийском телефонном номере?

Семь цифр после кода страны +220, без префикса внутренней сети, который нужно было бы добавлять или убирать.

Сколько стоит SMS-верификация в Гамбии?

От $0.20 за код; актуальную цену для каждого сервиса возвращает API, а личный кабинет показывает её до заказа.

Всегда ли код WhatsApp дойдёт до гамбийского номера?

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

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

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

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