Skip to main content
Tranzor позволяет продавать eSIM через API. Вы получаете доступ к тарифам для 150+ стран, а ваши клиенты получают мгновенную активацию через QR-код.

​
Как это работает

1

Получите список тарифов

Запросите GET /api/v1/esim — вы получите тарифы по странам с ценами в USD. Можно фильтровать по стране или искать по названию.
2

Оформите заказ

Отправьте POST /api/v1/esim/order с planId выбранного тарифа. Баланс спишется автоматически.
3

Отдайте QR-код клиенту

В ответе вы получите qrcode (LPA activation code) и qrImage (Base64 PNG). Клиент сканирует QR и eSIM устанавливается на устройство.
4

Отслеживайте использование

Через GET /api/v1/esim/{orderId} можно получить live-данные об использовании трафика: сколько осталось, сколько потрачено, когда истекает.

​
Поддерживаемые устройства

eSIM поддерживается на большинстве современных устройств:
  • iPhone — XR, XS и новее
  • iPad — Pro (3-го поколения и новее), Air (3-го поколения и новее), Mini (5-го поколения и новее)
  • Samsung — Galaxy S20 и новее, Galaxy Z Fold/Flip
  • Google Pixel — 3a и новее
Полный список совместимых устройств возвращается в ответе GET /api/v1/esim в поле supportedDevices.

​
Тариф

Каждый тариф содержит:
ПолеТипОписание
idstringID тарифа для покупки
dataGbstringОбъём данных в ГБ
daysintegerСрок действия в днях
priceUsdnumberЦена в USD
operatorsstringОператоры в стране

​
Заказ eSIM

После покупки вы получаете:
ПолеОписание
orderIdID заказа
statuspending → active → expired / failed
esim.iccidУникальный ID SIM-карты
esim.qrcodeLPA activation code (строка для программной активации)
esim.qrImageBase64 PNG — QR-код для сканирования
esim.iosTapLinkСсылка для установки на iOS в один тап
esim.dataLeftMbОстаток трафика в МБ
esim.expiresAtДата истечения

​
Live-данные

Через эндпоинт GET /api/v1/esim/{orderId} можно получить актуальные данные об использовании: 
{
  "liveData": {
    "dataLeftMb": 3200,
    "dataPackageMb": 5120,
    "dataUsedMb": 1920,
    "expiresAt": "2025-02-15T00:00:00Z",
    "statusQr": "installed"
  }
}
ПолеОписание
dataLeftMbОстаток трафика в МБ
dataPackageMbПолный объём пакета в МБ
dataUsedMbИспользовано МБ
expiresAtДата истечения тарифа
statusQrСтатус QR: not_installed, installed, expired