eSIMfly MCP

eSIM API для разработчиков: продавайте eSIM в своём продукте

Интегрируйте оптовые тарифные планы eSIM для 200 стран в своё приложение, платформу или магазин через один REST API — каталог, заказы, пополнения, использование и полное управление жизненным циклом.

Кто использует eSIM API

Компании используют оптовую интеграцию eSIM, чтобы добавить доход от подключений в свой существующий продукт.

Travel-приложения и OTA

Предлагайте eSIM как дополнительную опцию при бронировании. Ваши путешественники остаются на связи с момента прилёта, а вы получаете маржу с каждого проданного тарифа.

Реселлеры и MVNO

Закупайте eSIM по оптовым ценам и продавайте через собственные каналы с вашими ценами и упаковкой.

IoT и платформы автопарков

Предоставляйте и отслеживайте связь для устройств и транспортных средств по всему миру через одну интеграцию.

Супераппы и финтех

Добавьте международные тарифные планы как встроенную функцию рядом с платежами, банковскими или лояльностными продуктами.

ВОЗМОЖНОСТИ API

Всё необходимое для программного управления eSIM

API покрывает весь путь — от просмотра оптовых пакетов до управления активными eSIM в полевых условиях.

Каталог и цены

Просматривайте все доступные пакеты данных с оптовыми ценами для 200 стран и проверяйте баланс аккаунта перед заказом.

Получить все пакетыПроверка баланса

Заказы и пополнения

Мгновенно выпускайте новые eSIM и пополняйте существующие. Заказы возвращают QR-коды и данные для активации, готовые к передаче вашим пользователям.

Создать заказПополнение пакетов и заказов

Жизненный цикл eSIM

Управляйте каждой выпущенной eSIM: проверяйте статус и использование данных, приостанавливайте или отменяйте линии, просматривайте сетевые события и отправляйте SMS.

Список / запрос eSIMСтатус eSIMОтмена / приостановка / активацияОтчёт об использованииСетевые событияОтправка SMS

Вебхуки

Регистрируйте конечные точки для получения уведомлений в реальном времени о событиях заказов и жизненного цикла eSIM — без опроса.

Управление вебхукамиУведомления о событиях

Оптовые тарифы eSIM, ваша маржа

Партнёры API покупают пакеты данных по оптовым ценам и устанавливают собственные розничные цены. Каталог охватывает локальные, региональные и глобальные тарифы в 200 странах и более чем 450 сетях, поэтому одна интеграция покрывает все направления, куда путешествуют ваши пользователи. Оплата по балансу упрощает расчёты: пополните счёт, и каждый заказ списывается с него по вашей оптовой ставке.

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

Безопасность по дизайну: запросы с HMAC-подписью

Каждый вызов API аутентифицируется подписью HMAC-SHA256 по временной метке запроса, уникальному ID запроса, вашему коду доступа и телу запроса — это обеспечивает проверку целостности и защиту от повторных атак. Готовые примеры подписания для Node.js, Python и PHP приведены в документации.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

Получите доступ к API за три шага

1. Создайте бизнес-аккаунт

Зарегистрируйте бизнес-аккаунт eSIMfly и расскажите нам о вашем сценарии использования и ожидаемом объёме.

2. Сгенерируйте ключи API

Создайте и управляйте учётными данными доступа в бизнес-панели, затем пополните баланс.

3. Интегрируйте и запускайте

Следуйте документации: просматривайте пакеты, разместите тестовый заказ и при необходимости зарегистрируйте вебхук для асинхронно выпускаемых eSIM.

FAQ

Ответы на вопросы об eSIM API

Что такое eSIMfly eSIM API?+

API eSIMfly — это REST API, который позволяет покупать, выпускать и управлять eSIM программно по оптовым ценам. Вы можете просматривать каталог пакетов, создавать заказы, пополнять тарифы, отслеживать использование и управлять полным жизненным циклом eSIM (активация, приостановка, отмена) из собственного приложения с покрытием в 200 странах и более чем 450 сетях.

Для кого предназначен eSIM API?+

API создан для компаний, которые хотят встроить eSIM-подключения в собственный продукт: travel-приложения и платформы бронирования, телеком-реселлеры и MVNO, IoT и платформы автопарков, а также любые сервисы, желающие предлагать международные данные своим пользователям без выстраивания отношений с операторами.

Как работает аутентификация в API?+

Запросы аутентифицируются подписями HMAC-SHA256. Каждый запрос содержит код доступа, уникальный ID запроса, временную метку и подпись, вычисленную с помощью вашего секретного ключа, что обеспечивает проверку целостности запроса и защиту от повторных атак. Примеры кода для Node.js, Python и PHP доступны в документации.

Как получить доступ к eSIM API?+

Создайте бизнес-аккаунт eSIMfly, затем сгенерируйте ключи API в бизнес-панели. Оптовые тарифы зависят от объёма — свяжитесь с нашей командой продаж, чтобы обсудить ставки для вашего ожидаемого объёма заказов.

Поддерживает ли API вебхуки?+

Да. Вебхуки уведомляют вас, когда асинхронно выпускаемые eSIM готовы — некоторые операторы (например, KDDI Japan) занимают несколько минут, и вместо опроса вы получаете подписанный POST с данными eSIM. Большинство провайдеров выпускают eSIM синхронно в ответе на заказ, а статус и использование запрашиваются через соответствующие конечные точки.

Каковы лимиты запросов к API?+

API позволяет 1 000 запросов в час на аккаунт. Запросы старше 5 минут отклоняются как часть защиты от повторных атак. Если вам нужны более высокие лимиты для вашей интеграции, свяжитесь с отделом продаж.

ОФИЦИАЛЬНЫЙ SDK · NODE.JS / TYPESCRIPT

Пропустите код подписания — установите SDK

npm install @esimfly/sdk предоставляет типизированный доступ ко всему API — встроены HMAC-подписание, свежие ID запросов, идемпотентные заказы, синхронизация каталога с паузами и проверка подписей вебхуков. Ноль зависимостей, Node.js 18+, лицензия MIT, открытый исходный код. SDK для PHP и Python — в разработке.

Используете ИИ-агента? Добавьте хостируемый MCP-сервер https://mcp.esimfly.net/mcp в Claude, ChatGPT или Cursor и войдите с бизнес-аккаунтом — вставлять ключи не нужно. Ищите тарифы, проверяйте использование и диагностируйте eSIM через живой API; по умолчанию только чтение, с шагом подтверждения перед любым заказом. Предпочитаете локальный вариант? npx -y @esimfly/mcp.

Учебные руководства по интеграции

Рабочий код на Node.js — от первого запроса до продакшн-вебхуков.

[

НАЧНИТЕ ЗДЕСЬ · РУКОВОДСТВО ПО АРХИТЕКТУРЕ

Руководство по интеграции eSIM API

Четыре строительных блока, подписанная аутентификация, синхронное и вебхук-выпускание, чек-лист оценки провайдеров и подводные камни, которые проявляются только в продакшене.

Читать руководство](https://esimfly.net/esim-api/integration-guide)

[

ЧАСТЬ 1 · ~30 МИН

Продавайте eSIM в своём приложении с Node.js

HMAC-аутентификация, каталог пакетов, создание заказов и доставка QR-кодов — полностью рабочий магазин.

Начать руководство](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

ЧАСТЬ 2 · ЖИЗНЕННЫЙ ЦИКЛ

Пополнения, отслеживание использования и вебхуки

Запросы живого использования, продажа пополнений на существующих eSIM и подписанные вебхуки без опроса.

Перейти ко второй части](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

Готовы интегрировать eSIM в свой продукт?

Начните с документации или обсудите с нашей командой оптовые ставки для вашего объёма.