Колумбийские номера для верификации: QA, запуски и маршрутизация OTP

Четыре вызова API, чтобы получить SMS-коды из Колумбии

Интеграция Colombia OTP API требует лишь нескольких запросов. Сначала убедитесь, что маршрут открыт, вызвав GET /api/v1/prices?country=co&service=whatsapp, подставив id нужного сервиса; ответ содержит актуальную цену пары. Затем создайте заказ через POST /api/v1/activations с JSON-телом, где указан сервис и co как страна. В ответ вы получите id активации и номер +57, который нужно ввести в тестируемое приложение.

Дальше дождитесь сообщения. Большинство команд регистрирует вебхук-эндпоинт и слушает activation.sms_received, другие вызывают GET /api/v1/activations/{id} с небольшим интервалом. Наконец, наведите порядок: если тест пошёл другим путём, POST /api/v1/activations/{id}/cancel снимает резерв средств. Каждый запрос подробно описан в документации для разработчиков.

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

Маршрутизация OTP для Колумбии охватывает более 1 900 сервисов в последнем срезе. Среди часто запрашиваемых — WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal и Netflix. Ёмкость меняется в течение дня, поэтому плановый тестовый прогон должен спрашивать у GET /api/v1/services и эндпоинта цен, что открыто прямо сейчас, а не полагаться на зашитый список.

Как форматировать мобильные номера +57 для хранения в E.164

Колумбийские мобильные номера содержат десять цифр после кода страны и начинаются с 3, так что формат E.164 выглядит как +57 3XX XXX XXXX. Внутри страны они набираются без ведущего нуля, поэтому нормализация проста: уберите пробелы, дефисы и скобки, сохраните знак плюс и 57 и запишите одну каноническую строку. Проверка ведущей тройки на стороне клиента поможет тестировщику, который вставил номер стационарного телефона, увидеть понятное сообщение вместо молчаливого сбоя на этапе SMS.

Что привлекает QA-команды на колумбийский рынок?

Колумбия — один из крупнейших испаноязычных рынков, и многие запуски в Латинской Америке начинаются именно там или рядом. Проверочные сообщения обычно приходят на испанском, поэтому при проверке локализации нужно убедиться, что ваш собственный шаблон читается естественно, что символы с диакритикой переживают кодировку и что цифры легко заметить внутри длинного предложения. Сервисы такси, доставки, платежей и маркетплейсы в регионе опираются на проверку телефона, поэтому номер +57 для тестирования постоянно встречается в релизных чек-листах. На нашей странице о QA-тестировании собраны подходы, которые работают с любым SMS verification API.

Код +57 опаздывает. Что делать?

Каждая активация остаётся открытой 20 минут. Если окно закрылось без SMS или вы отменили заказ раньше, вся сумма автоматически возвращается на кошелёк, а ваш эндпоинт получает activation.expired или activation.cancelled. Прежде чем пробовать снова:

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

Статья о снижении числа неудачных доставок OTP объясняет логику каждого шага.

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

Самостоятельно — нет. Выделенные виртуальные номера (Dedicated Virtual Numbers) с входящими и исходящими SMS и звонками из браузера продаются только для США и Канады, от $1.95 в месяц. Долгосрочную линию +57 из панели управления купить нельзя. Если вашей работе она нужна, напишите на [email protected]; возможность что-либо организовать зависит от местных правил, и заранее её обещать нельзя.

Оплата колумбийских верификаций

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

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

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

Да. Закажите номер +57 для проверяемого сервиса, введите его в форму регистрации и прочитайте код в панели управления или через вебхук. Ничего физического отправлять или активировать не нужно.

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

Войдите, откройте OTP Gateway, выберите сервис и Колумбию, проверьте цену и подтвердите. Номер появится на экране, а код отобразится рядом, как только придёт SMS.

Какой id страны использует API для Колумбии?

Используйте co в поле country и в запросах цен. Id сервисов берутся из GET /api/v1/services, например telegram или uber.

Плачу ли я за номер +57, на который код так и не пришёл?

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

На каком языке будет колумбийское проверочное SMS?

Это зависит от отправителя, хотя колумбийские пользователи в основном видят испанские шаблоны. Извлекайте цифры, а не сопоставляйте фиксированный текст: шаблоны меняются без предупреждения.

Может ли мой CI-конвейер самостоятельно получать SMS-коды из Колумбии?

Да. Создайте активацию из конвейера, дождитесь вебхука или опрашивайте активацию и передайте код в тест. Наша заметка про тестирование OTP в CI рассказывает о тайм-аутах и очистке.

Как понять, что вебхук действительно пришёл от OTP Route?

Каждый запрос содержит X-OTPRoute-Signature с меткой времени и HMAC-SHA256 от этой метки, точки и необработанного тела, подписанным секретом вашего эндпоинта. Пересчитайте его, сравните за постоянное время и отбрасывайте устаревшие метки времени.

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

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

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