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

Какие эндпоинты вызывать, чтобы получить код +507?

Всё находится под https://otproute.com/api/v1, авторизация — Bearer-ключом с префиксом or_live_. Идентификатор страны для Панамы — pa. Типичный прогон тест-кейса выглядит так:

1. GET /api/v1/prices?country=pa&service=whatsapp возвращает актуальную ставку для этой пары, чтобы ваш раннер мог остановиться, если она превышает заданный вами бюджет.
2. POST /api/v1/activations с телом {"service": "whatsapp", "country": "pa"} резервирует номер и возвращает id активации.
3. Ваш тест вводит номер на экране регистрации и запускает отправку SMS.
4. Код приходит через событие вебхука или через GET /api/v1/activations/{id}.
5. POST /api/v1/activations/{id}/cancel досрочно завершает прогон и возвращает деньги.

Вызывайте GET /api/v1/balance перед большим набором тестов, чтобы пустой кошелёк не проявился волной ложных падений. Подробности запросов и ответов — в обзоре для разработчиков и полном справочнике API.

Что выбрать для маршрутов Панамы: вебхуки или опрос?

Для интеграции Panama OTP API вебхуки — более чистый вариант. Зарегистрируйте эндпоинт (до 5 на аккаунт) и подпишитесь на activation.sms_received, activation.expired и activation.cancelled. Каждый запрос содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>; пересчитайте HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, сравните за постоянное время и отбрасывайте всё со старой меткой времени. Привяжите обработчик к id активации, чтобы повторная доставка никогда не обработала один код дважды.

Опрос подходит для коротких скриптов и сетей, которые не принимают входящие вызовы. Разносите запросы по времени: лимит аккаунта — 300 запросов в минуту на все до 10 ключей, и частый цикл по одной активации тратит этот бюджет впустую. Больше схем — в нашей статье о приёме OTP через вебхуки.

Что должен знать ваш код о телефонных номерах Панамы?

В Панаме нет префикса междугородной связи, поэтому национальные цифры идут после +507 без изменений. Мобильные номера состоят из восьми цифр и начинаются с 6, а стационарные — из семи, что важно, если ваш валидатор требует единую длину для всей страны.

• Храните номера в E.164, например +5076 и ещё семь цифр для мобильного.
• Принимайте при вводе дефис после четвёртой цифры — это распространённая местная запись мобильных, — а перед сохранением убирайте его.
• В сценариях только с SMS отклоняйте семизначный ввод: почти наверняка это стационарный номер, который не получит код.

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

Зачем командам вообще тестировать или работать в Панаме?

Канал, судоходство и логистика, а также крупный сектор международных услуг делают Панаму частой базой региональных штаб-квартир для Центральной Америки и Карибского бассейна. Продуктовые команды, запускающие испаноязычное приложение в регионе, нередко начинают локализационный QA именно здесь, а операционным командам из других стран всё равно нужно доказать, что клиенты с номерами +507 могут пройти онбординг.

Номер верификации Панамы из OTP Gateway позволяет сделать это из любого офиса. Если тесту Панама не нужна именно как страна, соседние маршруты, такие как Коста-Рика или Колумбия, могут стать полезным сравнением по поведению маршрутизации стран.

Какие сервисы получают коды на панамском маршруте?

В сегодняшнем срезе есть WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Uber, eBay, Airbnb и Netflix. Всего на маршруте сейчас более 1 000 сервисов. Наличие меняется в течение дня, поэтому всегда читайте GET /api/v1/services или кабинет, а не зашивайте список в код.

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

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

20-минутное окно — ваша страховка: плата берётся только при получении кода, а истёкшая или отменённая активация автоматически возвращает всю сумму. Если номер молчит:

• Дайте ему дойти до истечения, а не отменяйте и не перезаказывайте через считаные секунды; плотные циклы выглядят подозрительно для отправляющего сервиса.
• Повторите после паузы или попробуйте другой маршрут сервиса.
• Убедитесь, что сервис принимает виртуальные номера; некоторые отклоняют их напрямую, и возврат существует именно для этого случая.
• Логируйте событие activation.expired, чтобы нестабильные прогоны были заметны, а не тихо пропадали.

Эти номера предназначены для тестирования и работы с вашими собственными легитимными аккаунтами. Соблюдайте условия каждого отправляющего сервиса и помните, что каждый заказ регулируется Политикой допустимого использования OTP Route.

Что с долгосрочными номерами Панамы, оплатой и тестированием в песочнице?

OTP Route не продаёт самостоятельно оформляемый долгосрочный номер Панамы. Dedicated Numbers (выделенные номера) доступны только в США и Канаде, от $1.95/month; по панамской линии напишите на [email protected], и команда скажет, допускают ли это местные правила.

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

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

Можно ли автоматизировать SMS-верификацию Панамы в моём CI-пайплайне?

Да. Создавайте активации со страной pa через REST API и получайте код с подписанного вебхука или опросом активации.

Какой длины мобильные номера в Панаме?

Мобильные номера состоят из восьми цифр, начинающихся с 6, и пишутся после +507; префикса, который нужно убирать, нет.

Сколько стоит получить панамский SMS-код OTP?

От $0.20 за код; эндпоинт цен API возвращает точную сумму для каждого сервиса до заказа.

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

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

Будут ли сообщения с кодами из Панамы на испанском?

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

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

Да. Номер +507 из OTP Gateway принимает по одному коду за раз, так что вашей команде не нужен панамский телефон.

Можно ли купить постоянный номер +507?

Самостоятельно нельзя. Долгосрочные Dedicated Numbers — продукт для США и Канады; о Панаме спросите по адресу [email protected].

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