190+
Стран покрытия
10–30 с
Выдача QR-кода
600+
Тарифных планов
99.5%
Аптайм сервиса
Типы тарифных планов
GET /esim/plans возвращает полный каталог с фильтрами по стране, региону, размеру трафика и сроку действия.
Одна страна
Несколько стран
Весь мир
Как работает продажа eSIM
Выберите план
GET /esim/plans — фильтрация по стране назначения, трафику, сроку. Покупатель выбирает подходящий вариант.
Создайте заказ
POST /esim/orders — API выдаёт QR-код и SM-DP+ адрес для ручной активации. Срок не начинается до первого подключения.
Покупатель активирует
Сканирует QR в настройках → «Мобильные данные» → «Добавить eSIM». Готово к использованию за 1–2 минуты.
Жизненный цикл eSIM
Выдан
QR-код создан, eSIM ещё не установлена на устройство.
Активна
Устройство подключилось к сети. Отсчёт срока и трафика начался.
Пополнена
Добавлен трафик или продлён срок через POST /esim/{id}/topup.
Истекла
Закончился трафик или срок действия. Webhook esim.expired отправлен.
Основные эндпоинты
Документация
/esim/plans
Каталог планов с фильтрами
/esim/plans/{id}
Детали плана, покрытие, операторы
/topup/validate
Проверить аккаунт игрока
/esim/orders
Создать заказ, получить QR-код
/esim/orders/{id}
Статус, трафик, срок действия
/esim/{id}/topup
Пополнить трафик или продлить срок
/webhooks
Регистрация Webhook-адреса
{
"plan_id": "eu-regional-20gb-30d",
"quantity": 1,
"zone_id": "8001",
"external_order_id": "your-order-555"
}{
"order_id": "esim_3nk8w..",
"status": "issued",
"qr_code_base64": "iVBORw0KGgo...",
"smdp_address": "1\$rsp.giapi.com\$ESIM-8KX2",
"iccid": "89011012012341234512",
"expires_after_activation_days": 30,
"data_gb": 20
}Технические преимущества
QR и SM-DP+ в одном ответе
Покажите QR для сканирования или SM-DP+ строку для ручного ввода — оба формата в теле ответа.
Пополнение активной eSIM
POST /esim/{id}/topup — добавить гигабайты или продлить срок без новой покупки и повторной активации.
Срок с первого подключения
Отсчёт начинается не с момента покупки, а когда устройство впервые выходит в сеть через eSIM.
Webhook-события
esim.activated, esim.data_low (остаток <20%), esim.expired — мониторинг жизненного цикла в реальном времени.
Совместимость устройств
iPhone и iPad
iPhone XS и новее, iPad Pro (2018+), iPad Air (2019+), iPad mini (2019+). iOS 12.1 и выше.
Android
Google Pixel 2+, Samsung Galaxy S20+, большинство флагманов 2020 года и новее с поддержкой eSIM.
Поле is_esim_compatible в каталоге
GET /esim/plans/{id} содержит список совместимых устройств. Рекомендуем показывать его до оплаты, чтобы снизить возвраты.
Частые вопросы
С какого момента начинается отсчёт срока действия?
Срок начинается с момента первого подключения устройства к сети через eSIM, а не с момента покупки. Это позволяет продавать eSIM заранее — например, как подарок перед поездкой. Поле activated_at в GET /esim/orders/{id} фиксирует точное время.
Можно ли использовать eSIM одновременно с физической SIM?
Да, если устройство поддерживает Dual SIM. Покупатель может оставить основную SIM для звонков и SMS, а eSIM использовать для мобильного интернета за рубежом.
Что происходит при исчерпании трафика?
Интернет прекращает работу. Webhook esim.data_low приходит при остатке менее 20% — это позволяет предложить пополнение заранее. Пополнение через POST /esim/{id}/topup добавляет трафик без переустановки.
Можно ли переустановить eSIM на другое устройство?
Нет — по стандарту GSMA каждый QR-код можно использовать один раз и привязывается к конкретному устройству. Это ограничение на уровне индустриального стандарта, не API.