Коды подтверждения из Новой Каледонии (+687) для продуктовых команд и QA

Одноразовый код или долгосрочная линия: что нужно проекту для Новой Каледонии?

Решите это в первую очередь, потому что от этого зависит вся остальная интеграция.

• Номера OTP Gateway предназначены для одной верификации. Вы резервируете номер +687, получаете один код, и активация завершается. Это подходит для тестов регистрации, проверок локализации и CI-прогонов, которые каждый раз создают новый тестовый аккаунт.
• Выделенные номера (Dedicated Numbers) — линии, которые остаются за вами, пока продлеваются, с входящими и исходящими SMS и звонками из браузера. Они продаются только в США и Канаде, от $1.95/месяц, и самостоятельного аналога для Новой Каледонии нет.

Если линия Новой Каледонии должна месяцами оставаться за аккаунтом, напишите на [email protected] и опишите сценарий; возможность зависит от местных правил и обещана быть не может. Для всего, где нужен один код за раз, правильный инструмент — шлюз. Подробнее — в нашем сравнении временных и выделенных номеров.

Как вызывать OTP Gateway для маршрута Новой Каледонии?

Все запросы идут на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_. Создавайте ключи в консоли разработчика (до 10 на аккаунт) и ротируйте их для каждой среды.

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

Перед пакетом заказов стоит вызвать GET /api/v1/balance, чтобы прогон быстро завершался ошибкой при пустом кошельке. Страница для разработчиков собирает заметки по SDK и документацию по этому OTP API для Новой Каледонии.

Как выглядят подписанные вебхуки для кодов +687?

Зарегистрируйте до 5 эндпоинтов и выберите нужные события: activation.sms_received, activation.expired и activation.cancelled. Каждая доставка приходит с заголовком X-OTPRoute-Signature вида t=<unix>,v1=<hex>.

Чтобы доверять доставке, подпишите <t>.<raw body> с помощью HMAC-SHA256 и секрета эндпоинта, затем сравните результат с v1 за постоянное время. Отбрасывайте всё с устаревшей меткой времени. Поскольку одно и то же событие может прийти повторно, индексируйте обработанные события по идентификатору активации и пропускайте дубликаты. Команды, которые предпочитают опрос, могут пользоваться им в пределах лимита 300 запросов в минуту.

Какие сервисы могут получать SMS с OTP из Новой Каледонии?

Сейчас на маршруте более 700 сервисов. Актуальный срез включает WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Netflix, Telegram, LinkedIn, Snapchat и TikTok.

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

Чем номера +687 отличаются для валидации и локализации?

В Новой Каледонии используется закрытый шестизначный план нумерации без магистрального префикса, поэтому формат E.164 — просто +687 и шесть цифр. Валидаторы, настроенные на более длинные национальные номера, часто его отклоняют, и это делает его полезным пограничным случаем для любого поля телефона. Храните полную строку E.164 и не применяйте правила длины, скопированные с другого рынка.

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

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

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

Кабинету код не нужен. Зарегистрируйтесь по электронной почте и 6-значному коду или через Google и включите TOTP. Пополните кошелёк, выберите Новую Каледонию и сервис и подтвердите, проверив показанную цену. Вставьте номер +687 в приложение и следите за активацией, пока не появится код.

Что делать, если за 20 минут ничего не пришло?

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

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

Как тарифицируется тест для Новой Каледонии?

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

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

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

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

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

Какой идентификатор страны у Новой Каледонии в API?

Это nc; он используется и в запросе цен, и в теле запроса на активацию.

Какой длины номер телефона в Новой Каледонии?

Шесть цифр после кода страны +687, без магистрального префикса. Храните его в E.164 и не применяйте правила длины других стран.

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

От $0.20 за код; точную актуальную цену для сервиса возвращает GET /api/v1/prices до заказа.

Можно ли оформить долгосрочный номер Новой Каледонии?

Самостоятельного варианта там нет; долгосрочные выделенные номера — только США и Канада. О линии Новой Каледонии можно спросить, написав на [email protected].

На каком языке приходят OTP-сообщения в Новой Каледонии?

Обычно на французском или английском, в зависимости от сервиса. Разбирайте числовой код, чтобы работали оба варианта.

Возвращаются ли деньги за заказ +687, если код так и не пришёл?

Да, как только закроется 20-минутное окно или вы отмените заказ, кошелёк автоматически получает всю сумму обратно.

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