Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tranzor.io/llms.txt

Use this file to discover all available pages before exploring further.

Tranzor позволяет продавать eSIM через API. Вы получаете доступ к тарифам для 150+ стран, клиент оплачивает криптовалютой, а eSIM активируется автоматически после подтверждения платежа.

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

1

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

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

Создайте заказ

Отправьте POST /api/v1/esim/order с planId выбранного тарифа. В ответе вы получите payUrl, адреса для крипто-оплаты и orderId для отслеживания. Статус заказа — pending.
3

Клиент оплачивает

Перенаправьте клиента на payUrl или покажите адреса из addresses в своём интерфейсе. Клиент оплачивает криптовалютой (USDT, ETH и др.).
4

eSIM активируется автоматически

После подтверждения платежа система автоматически создаёт eSIM. Статус заказа меняется: pending → provisioning → active.
5

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

Когда status = active, в ответе GET /api/v1/esim/{orderId} появятся qrcode (LPA строка), qrImage (Base64 PNG) и iosTapLink. Клиент сканирует QR и eSIM устанавливается на устройство.
6

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

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

​
Статусы заказа

СтатусОписание
pendingЗаказ создан, ожидает оплаты инвойса
provisioningОплата получена, eSIM создаётся
activeeSIM готов — QR-код и ICCID доступны
failedОшибка: таймаут оплаты или сбой активации

​
Пример: полный флоу

​
1. Выбор тарифа

curl -H "Authorization: Bearer trz_your_key" \
  "https://sand.tranzor.io/api/v1/esim?country=DE"

{
  "success": true,
  "data": {
    "countries": [{
      "country": "Германия",
      "countryIso": "DE",
      "plans": [{
        "id": "plan_de_5gb_30d",
        "dataGb": "5",
        "days": 30,
        "priceUsd": 12.50,
        "operators": "T-Mobile, Vodafone"
      }]
    }]
  }
}

​
2. Создание заказа

curl -X POST https://sand.tranzor.io/api/v1/esim/order \
  -H "Authorization: Bearer trz_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "plan_de_5gb_30d",
    "clientEmail": "user@example.com",
    "clientRef": "my-order-123"
  }'

{
  "success": true,
  "data": {
    "orderId": "esim_abc123",
    "status": "pending",
    "invoiceId": "inv_xyz789",
    "payUrl": "https://pay.tranzor.io/inv_xyz789",
    "amount": 12.50,
    "currency": "USD",
    "plan": {
      "country": "Германия",
      "countryIso": "DE",
      "dataGb": "5",
      "days": 30
    },
    "addresses": [
      {
        "chain": "tron",
        "address": "TXyz...",
        "expectedAmount": "12500000",
        "isToken": true,
        "tokenSymbol": "USDT"
      }
    ],
    "expiresAt": "2025-01-01T01:00:00Z"
  }
}

​
3. Polling статуса после оплаты

curl -H "Authorization: Bearer trz_your_key" \
  "https://sand.tranzor.io/api/v1/esim/esim_abc123"

{
  "success": true,
  "data": {
    "orderId": "esim_abc123",
    "status": "active",
    "plan": { "country": "Германия", "dataGb": "5", "days": 30 },
    "esim": {
      "iccid": "8949...",
      "qrcode": "LPA:1$...",
      "qrImage": "data:image/png;base64,...",
      "iosTapLink": "https://esimsetup.apple.com/esim_dep..."
    },
    "liveData": {
      "dataLeftMb": 5120,
      "dataPackageMb": 5120,
      "dataUsedMb": 0,
      "expiresAt": "2025-01-31T00:00:00Z",
      "statusQr": "installed"
    }
  }
}
Поле esim доступно только когда status = active. При других статусах оно будет null.

​
Параметры заказа

ПолеОбязательноеОписание
planIdдаID тарифа из GET /api/v1/esim
clientEmailнетEmail клиента — получит уведомление об активации
clientRefнетВаш внутренний ID заказа (используется как orderId инвойса)

​
Данные eSIM (при status=active)

ПолеОписание
iccidУникальный ID SIM-карты
qrcodeLPA activation string — для программной активации
qrImageBase64 PNG — QR-код для сканирования камерой
iosTapLinkСсылка для установки на iOS в один тап

​
Live-данные

ПолеОписание
dataLeftMbОстаток трафика в МБ
dataPackageMbПолный объём пакета в МБ
dataUsedMbИспользовано МБ
expiresAtДата истечения тарифа
statusQrСтатус QR: not_installed, installed, expired

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

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