Приём болгарских кодов подтверждения на номера +359

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

Большинство команд, задающих этот вопрос, оказываются в одной из трёх ситуаций: продукт скоро запускается в Болгарии, и QA хочет увидеть реальный сценарий регистрации; региональная операционная группа ведёт бизнес-профили, зарегистрированные на контакт +359; или агентство проверяет онбординг клиента из-за границы. Рассылать болгарские SIM-карты под каждый случай медленно, а пластик потом лежит в ящиках столов.

OTP Gateway заменяет это одним запросом: выберите сервис и Болгарию, получите временный номер верификации +359 и прочитайте код, когда сервис его отправит. Один номер обслуживает одну верификацию. Маршруты предоставляют наши операторы-партнёры, а OTP Route берёт на себя OTP-маршрутизацию, таймер и автоматический возврат.

Какие сервисы можно подключить через номер +359?

В актуальном срезе по Болгарии указано более 1 600 сервисов. Среди популярных, доступных сейчас: WhatsApp, Viber, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, eBay, Uber, Discord и Signal.

Viber заслуживает особого упоминания, поскольку в Болгарии он широко используется для личного и делового общения, поэтому местный план QA часто проверяет его наряду с WhatsApp. Наличие маршрутов меняется в течение дня, и поэтому списки цен и сервисов берутся из API в момент запроса, а не из статичной таблицы.

Как выглядит последовательность вызовов OTP API для Болгарии?

Создайте Bearer-ключ (префикс or_live_) в консоли разработчика, затем обращайтесь к https://otproute.com/api/v1:

1. Один раз получите GET /api/v1/services и GET /api/v1/countries и закэшируйте идентификаторы; Болгария — это bg.
2. Узнайте текущую ставку через GET /api/v1/prices?country=bg&service=<id>.
3. Откройте активацию через POST /api/v1/activations с телом вроде {"service": "viber", "country": "bg"}.
4. Дождитесь вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id}, если ваш раннер не может открыть эндпоинт.
5. Если тест прервался раньше времени, отправьте POST /api/v1/activations/{id}/cancel, чтобы деньги сразу вернулись.

Проверяйте заголовок X-OTPRoute-Signature в каждой доставке (HMAC-SHA256 от метки времени и необработанного тела) и отбрасывайте устаревшие метки времени. В документации для разработчиков перечислены лимиты аккаунта: 10 ключей, 5 эндпоинтов вебхуков, 300 запросов в минуту.

Как хранить и нормализовать номера +359?

Внутри страны болгары записывают номера с ведущим префиксом 0, поэтому мобильный номер 088 123 4567 в международном виде превращается в +359 88 123 4567; ноль после кода страны исчезает. Сохраняйте форму E.164 и форматируйте только для отображения. Если форма принимает местный ввод, удаляйте пробелы, дефисы и этот ведущий ноль перед валидацией. Классическая ошибка — сохранить +3590…: ни один маршрут такой номер не доставит.

Имеет значение и письменность. Болгарский пишется кириллицей, а сервисы, локализующие тексты, окружают код кириллическими словами. Кириллические сообщения передаются в UCS-2, из-за чего один сегмент сокращается до 70 символов, и длинный локализованный шаблон может прийти разбитым. Если цифры извлекает регулярное выражение, проверьте его на кириллическом окружении, а не только на английском.

Что делать, если код не появляется?

Дайте 20-минутному окну отработать, прежде чем делать выводы: некоторые приложения отправляют с задержкой или только после повторного нажатия «отправить снова». Если ничего не пришло, OTP Route автоматически возвращает полную сумму на кошелёк, а событие activation.expired сообщает вашей системе, что слот закрыт. После этого:

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

Наш материал о снижении числа неудачных доставок OTP раскрывает тему подробнее.

Есть ли долгосрочная болгарская линия и как устроена оплата?

Самостоятельного оформления долгосрочного болгарского номера сегодня нет. Dedicated Numbers — продукт для США и Канады от $1.95 в месяц; если вашей команде нужна постоянная линия +359, напишите на [email protected], и команда рассмотрит вопрос, хотя возможность определяется местными правилами.

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

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

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

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

Какой идентификатор страны для Болгарии в API SMS-верификации?

Используйте bg в поле country запроса POST /api/v1/activations и при запросе цен. Идентификаторы сервисов берутся из GET /api/v1/services.

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

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

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

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

Придут ли болгарские коды кириллицей или латиницей?

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

Могу ли я сохранить тот же номер +359 для последующих входов?

Через OTP Gateway — нет, потому что каждый номер рассчитан на одну верификацию. Долгосрочные номера доступны самостоятельно только в США и Канаде; по Болгарии напишите на [email protected] и уточните.

Предназначен ли OTP Route для массовой регистрации аккаунтов?

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

Как начать работу с болгарскими номерами?

Создайте аккаунт по почте и 6-значному коду или через вход Google, пополните кошелёк, затем заказывайте из панели или создайте API-ключ.

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