Путь разработчика к одноразовым кодам Лаоса (+856)

Какой кратчайший путь от API-ключа до кода на +856?

Начните в консоли разработчика: создайте Bearer-ключ (он начинается с or_live_) и держите по одному на каждое окружение — на аккаунт допускается десять. Все запросы идут на https://otproute.com/api/v1, идентификатор страны для Лаоса — la. Минимальный сценарий выглядит так:

1. Найдите идентификатор сервиса через GET /api/v1/services; идентификаторы стран берутся из GET /api/v1/countries.
2. Запросите GET /api/v1/prices?country=la&service=<id>, чтобы узнать стоимость заказа и открыта ли эта пара прямо сейчас.
3. Создайте активацию через POST /api/v1/activations с телом вида {"service": "telegram", "country": "la"}. В ответе будут идентификатор активации и лаосский номер.
4. Введите номер в тестируемом приложении и дождитесь кода.
5. Если тест завершён раньше, POST /api/v1/activations/{id}/cancel снимает удержание.

Это весь набор методов Laos OTP API, который нужен базовому тесту. Ответы и коды ошибок описаны в обзоре для разработчиков и полной документации.

Опрос или вебхуки: что подходит для тестов в Лаосе?

Для разового скрипта вполне подходит опрос GET /api/v1/activations/{id} раз в несколько секунд; при лимите 300 запросов в минуту на аккаунт несколько параллельных задач всё равно укладываются. Крупным наборам тестов лучше push-доставка. Добавьте до пяти вебхук-эндпоинтов и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

У принимающего обработчика три обязанности. Во-первых, проверить X-OTPRoute-Signature (t=<unix>,v1=<hex>): вычислить HMAC-SHA256 от <t>.<raw body> секретом эндпоинта. Во-вторых, отклонять устаревшие метки времени. В-третьих, быть идемпотентным, записывая идентификатор активации, чтобы повторная доставка события ничего не меняла. Другие схемы — в статье о приёме OTP через вебхуки.

Как записываются лаосские номера и на каком языке приходят коды?

Внутри страны лаосские номера набираются с транковым 0, а в международном формате этот ноль исчезает. Мобильные номера обычно начинаются с 20 после кода страны, так что местный номер 020 превращается в +856 20 и цифры абонента в формате E.164. Храните именно E.164 и убирайте транковый ноль при нормализации; иначе поиск по таблице пользователей пропустит дубликаты, записанные обоими способами.

Лаосский — официальный язык со своей письменностью. Если ваш продукт отправляет локализованные шаблоны OTP, убедитесь, что лаосские символы выдерживают SMS-кодировку, а цифры остаются легко различимыми: длинное сообщение в Unicode может разбиться на несколько частей. Многие международные сервисы оставляют текст верификации для этого рынка на английском, поэтому парсер должен справляться с обоими вариантами.

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

Страна граничит с Таиландом, Вьетнамом, Китаем, Камбоджей и Мьянмой, и многие региональные приложения рассматривают её как часть более широкого запуска в бассейне Меконга. Номер +856 для тестирования обычно нужен, когда лаосский язык добавляют в релиз локализации, запускают трансграничный кошелёк или службу доставки либо поддерживают пользователей, перемещающихся между Лаосом и соседними рынками. Прогон регистрации через реальный лаосский маршрут выявляет проблемы форматирования, ограничений частоты и шаблонов до того, как о них сообщат клиенты. О том, как принимаются решения по OTP-маршрутизации для отдельных рынков, рассказывает руководство по маршрутизации по странам.

Какие сервисы открыты на маршрутах +856?

В текущем каталоге для la указано более 1 700 сервисов. Из популярных на момент написания — WhatsApp, Facebook, LINE, WeChat, TikTok, Telegram, Google (Gmail и YouTube), imo, Shopee, Lazada, Zalo, Instagram и ChatGPT (OpenAI). Доступность меняется вместе с ёмкостью партнёров, поэтому при каждом запуске спрашивайте об этом эндпоинт цен.

Без кода всё делается быстро: выберите сервис, выберите Лаос, проверьте показанную цену, сделайте заказ и следите за карточкой активации, пока не появится код.

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

Каждая активация удерживает номер 20 минут. Вы платите только в случае, если код пришёл; при истечении срока или отмене деньги автоматически возвращаются на кошелёк.

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

Долгосрочные линии, оплата и sandbox для Лаоса

В OTP Route нет самообслуживаемого долгосрочного лаосского номера. Dedicated Numbers — продукт для США и Канады, от $1.95/месяц; если нужна линия +856, напишите на [email protected], и команда сообщит, позволяют ли это местные правила, без каких-либо обещаний.

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

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

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

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

Какой идентификатор страны OTP Route использует для Лаоса?

la. Применяйте его в запросе цен и в теле запроса на активацию.

Нужно ли сохранять ведущий 0 в лаосских номерах?

Только для набора внутри страны. В формате E.164 и в вашей базе данных отбросьте его и храните +856 и национальный номер.

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

От $0.20 за код. Точная цена зависит от сервиса и возвращается методом GET /api/v1/prices до оформления заказа.

Возврат автоматический, если код так и не пришёл?

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

Что считается допустимым использованием номеров +856?

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

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