Выбор подходящего инструмента для телефонной верификации в Коста-Рике (+506)

Одноразовый номер +506 или линия, которую вы сохраняете: что нужно?

Начните с вопроса, как часто аккаунт, привязанный к номеру, будет снова запрашивать код.

• Один код — и всё. Тест регистрации, смоук-проверка запуска или подтверждение одного бизнес-аккаунта в Коста-Рике подходят для OTP Gateway. Вы получаете номер +506 ровно для одного проверочного кода, и активация после этого закрывается.
• Повторные входы на протяжении месяцев. Для такого сценария нужен номер, который вы держите за собой. OTP Route продаёт Dedicated Virtual Numbers (выделенные виртуальные номера) только в США и Канаде, от $1.95 в месяц, с входящими SMS, исходящими SMS и звонками из браузера.

Самостоятельной долгосрочной костариканской линии нет. Если вашей работе она действительно нужна, напишите на [email protected], и команда изучит вопрос, но возможность её предложить зависит от местных правил и не обещается. Для staging-аккаунта, в который нужно входить снова и снова, практичным ответом часто становится американский или канадский выделенный номер, если сервис принимает этот регион.

Какие приложения могут присылать коды на проверочный номер Коста-Рики?

В маршруте Коста-Рики сейчас числится более 800 сервисов. Среди популярных, доступных прямо сейчас, — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, Uber, Airbnb, Microsoft & Outlook, Amazon, LinkedIn, Discord, ChatGPT (OpenAI), Signal и Netflix.

Считайте этот список снимком. Инвентарь меняется в течение дня, поэтому надёжный источник — актуальный вызов цены и доступности, а не какой-либо текст на странице, включая этот. Uber и Airbnb часто встречаются в костариканских тест-планах, потому что сценарии поездок и путешествий проверяют команды, которые разрабатывают продукты и для гостей страны, и для жителей.

Как Costa Rica OTP API работает от запроса до кода?

Всё идёт на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_, созданным в консоли разработчика. На аккаунте может быть до 10 ключей и 5 вебхук-эндпоинтов, а лимит — 300 запросов в минуту.

1. Прочитайте GET /api/v1/services и GET /api/v1/countries, чтобы сопоставить названия с id. Коста-Рика — это cr.
2. Перед каждым заказом запрашивайте актуальную цену через GET /api/v1/prices?country=cr&service=<id>.
3. Создайте активацию через POST /api/v1/activations с телом вроде {"service": "whatsapp", "country": "cr"}. Сохраните возвращённый id активации.
4. Введите номер +506 на экране регистрации, который тестируете.
5. Пусть ваш вебхук поймает activation.sms_received, либо проверяйте GET /api/v1/activations/{id} каждые несколько секунд, если вебхука нет.

Когда костариканский тест прерывается на полпути, верните номер через POST /api/v1/activations/{id}/cancel, чтобы кошелёк был пополнен. Запросы вебхука несут X-OTPRoute-Signature: t=<unix>,v1=<hex>; пересчитайте HMAC-SHA256 от <t>.<raw body> секретом эндпоинта, сравните и отбрасывайте устаревшие метки времени. Полная справка — в документации.

Может ли человек без навыков программирования заказать номер +506?

Да. Операционные сотрудники и аккаунт-менеджеры агентств обычно работают из панели управления:

1. Войдите и откройте OTP Gateway.
2. Выберите сервис, затем Коста-Рику как страну.
3. Проверьте цену, показанную перед подтверждением.
4. Скопируйте номер в форму верификации приложения.
5. Следите за активацией; код появится на том же экране, как только придёт.

Панель и API используют один кошелёк, поэтому QA-инженер и коллега из маркетинга могут работать с одного баланса без отдельной настройки.

Что инженерам стоит знать о костариканских номерах и SMS?

В Коста-Рике действует закрытый план нумерации с восьмизначными национальными номерами без транкового префикса. На практике это означает, что местная и международная формы отличаются только кодом страны +506, что делает нормализацию простой: храните каждый номер в E.164 как +506 и восемь цифр, убирая пробелы и дефисы, которые пользователи часто ставят посередине.

Официальный язык — испанский, поэтому многие проверочные сообщения приходят на испанском. Стройте парсер так, чтобы он вытаскивал последовательность цифр из тела, а не сопоставлял английскую фразу вроде «Your code is». Команды обычно тестируют здесь испаноязычную локализацию для Центральной Америки, работу nearshore-групп разработки, которым нужно местное QA-покрытие, а также туристические и гостиничные продукты, где гости и жители проходят один сценарий регистрации. Наше руководство по QA-тестированию показывает, как встроить это в релизный чек-лист.

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

Дайте активации полные 20 минут, прежде чем делать выводы. Если ничего не пришло, оплата автоматически возвращается на кошелёк — так же, как при отмене.

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

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

Как устроена оплата тестовых прогонов для Коста-Рики?

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

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

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

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

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

Какой id у Коста-Рики в API OTP Route?

cr — код ISO в нижнем регистре; он указывается и в строке запроса цен, и в теле запроса активации.

Есть ли в костариканских номерах ведущий ноль?

Нет. В Коста-Рике нет транкового префикса, поэтому храните +506 и восьмизначный национальный номер — и больше ничего.

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

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

Сколько стоит проверочный код +506?

От $0.20 за код, точная сумма зависит от сервиса. И API, и панель управления показывают актуальную цену перед заказом.

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

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

Могут ли мои разработчики отработать интеграцию +506, прежде чем платить за реальные заказы?

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

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