Подключаем SMS-верификацию +82 к вашему конвейеру релизов для Кореи

Через какие endpoint проходит активация +82?

Начните с SMS-API верификации — именно к нему в итоге приходит большинство корейских тест-планов. Каждый вызов отправляется на https://otproute.com/api/v1 с Bearer-ключом, начинающимся с or_live_, из консоли разработчика.

• GET /api/v1/countries возвращает kr для Южной Кореи; GET /api/v1/services даёт идентификаторы сервисов.
• GET /api/v1/prices?country=kr&service=<id> сообщает текущую цену и открыт ли маршрут.
• POST /api/v1/activations с телом {"service": "kakaotalk", "country": "kr"} резервирует номер +82 и возвращает идентификатор активации.
• GET /api/v1/activations/{id} показывает статус и, после получения, код.
• POST /api/v1/activations/{id}/cancel освобождает ненужный номер.
• GET /api/v1/balance позволяет набору тестов упасть раньше, если на кошельке мало средств.

Лимит аккаунта — 300 запросов в минуту, так что опрос раз в несколько секунд в параллельных задачах вполне комфортен. Полный цикл запросов показан в руководстве по интеграции.

Как подписанные вебхуки вписываются в корейский тестовый прогон?

Опрос подходит одному разработчику; параллельные CI-задачи удобнее обслуживать push-доставкой. Зарегистрируйте до пяти endpoint и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

Каждый запрос содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>. Возьмите сырое тело ровно в том виде, в каком оно получено, соберите строку <t>.<raw body>, вычислите HMAC-SHA256 с секретом endpoint и сравните с v1 проверкой с постоянным временем. Отклоняйте всё со старой отметкой времени, чтобы исключить повторную отправку, и привязывайте обработчик к идентификатору активации, чтобы повторная доставка не закрыла один и тот же тест дважды. Граничные случаи вроде повторной сериализации тела разобраны в статье про HMAC.

Какую задачу обычно решают команды, запускающиеся в Корее?

Южная Корея — требовательный рынок для мобильных приложений и игр, а корейские пользователи ждут качественной локализации. Команды тестируют здесь перед релизом, при добавлении экранов на корейском или когда очередь поддержки сообщает, что тексты верификации не доходят до корейских пользователей. Без местной SIM-карты принимать SMS OTP из Южной Кореи и воспроизводить такие обращения медленно. Разовый номер +82 из сервиса OTP-маршрутизации позволяет инженеру повторить точный сценарий из любого офиса, а код попадает в те же инструменты, что и для любого другого рынка.

Как форматируются и хранятся корейские номера телефонов?

Корейские мобильные внутри страны записываются как 010 и далее восемь цифр. Ведущий 0 — транковый префикс, поэтому в международной форме он опускается: +82 10 и остальные восемь цифр. Формы, принимающие оба стиля, должны на входе приводить значение к E.164; хранение 010… и +8210… бок о бок создаёт дубликаты пользователей и ломает поиск.

Сообщения от корейских отправителей обычно написаны хангылем, который передаётся как Unicode-SMS, тогда как глобальные приложения следуют языковой настройке аккаунта. Разбирайте коды по группе цифр, а не ожидая английского шаблона. Учтите также, что многие местные корейские сервисы привязывают регистрацию к проверке личности по настоящему имени через мобильного оператора абонента. Эта проверка рассчитана на персональные подписки, разовый номер её не пройдёт, и обходить её не нужно.

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

В снимке по kr — более 500 сервисов. Среди частых вариантов для номера верификации Южной Кореи — KakaoTalk, LINE, WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, TikTok, Discord, Netflix, Microsoft & Outlook, Amazon, Uber, ChatGPT (OpenAI) и Claude.

Покрытие меняется в течение дня, поэтому перед заказом всегда сверяйтесь с endpoint цен. Не разработчики могут сделать то же самое в панели: создайте аккаунт, откройте OTP Gateway, выберите сервис и Южную Корею, проверьте отображаемую цену, подтвердите и скопируйте номер +82 в приложение. Код появится на экране, как только придёт.

Что делать, если активация +82 остаётся пустой?

Окно активации — 20 минут, и платить нужно только в том случае, если код пришёл. Когда ничего нет:

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

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

Есть ли долгосрочный корейский номер и как устроена оплата?

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

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

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

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

Да. Закажите номер +82 через OTP Gateway, введите его в приложение и заберите код через API, вебхук или панель.

Нужно ли указывать ведущий 0 при вводе корейского номера в международном формате?

Нет. Отбросьте транковый префикс: мобильный 010 превращается в +82 10 и восемь цифр.

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

От $0.20 за код, точная цена зависит от сервиса. Актуальное значение приходит из endpoint цен и отображается в панели.

Пройдёт ли разовый номер корейскую проверку по настоящему имени?

Нет. Проверки личности через оператора привязаны к персональным подпискам, поэтому используйте OTP Route только для сценариев, принимающих обычные SMS-коды.

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

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

Можно ли сохранить южнокорейский номер для повторных входов?

В режиме самообслуживания — нет. Каждый разовый номер принимает один код, а долгосрочные линии доступны только в США и Канаде.

Какой код страны ожидает API для Южной Кореи?

Идентификатор страны — kr, он используется в запросе цен и в теле активации.

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