700+
Операторов в каталоге
150+
Стран покрытия
5–20 с
Время зачисления
99.7%
Успешных транзакций
Три типа пополнения
Поле type в GET /telecom/products позволяет фильтровать каталог по нужному типу пополнения.
Пополнение баланса
Пакет услуг
Смена тарифа
Автоопределение оператора по номеру
POST /telecom/lookup
Передайте номер телефона — API вернёт оператора, страну, тип (prepaid/postpaid) и доступные продукты. Вызывайте до отображения каталога, чтобы показать только релевантные предложения.
Как работает пополнение
Определите оператора
POST /telecom/lookup по номеру — получите оператора, тип абонента и список доступных продуктов.
Покажите каталог
GET /telecom/products?operator_id=… — только релевантные пакеты и тарифы для этого оператора и типа.
Создайте транзакцию
POST /telecom/topup — средства или пакет зачисляются на номер. Статус и webhook в реальном времени.
Регионы и примеры операторов
СНГ и Россия
MTS, Beeline, Megafon, Tele2, Kyivstar, Lifecell, Kcell, Ucell и 50+ операторов региона.
Азия и Ближний Восток
Airtel, Jio, Turkcell, Etisalat, STC, Ooredoo и 200+ операторов.
Африка и Латинская Америка
MTN, Airtel Africa, Claro, Movistar, Tigo, Digicel и 300+ операторов.
Европа
Orange, Vodafone, T-Mobile, O2, WindTre и операторы 40+ стран ЕС и СНГ.
Основные эндпоинты
Документация
/telecom/lookup
Определить оператора по номеру
/telecom/products
Каталог продуктов с фильтрами
/telecom/products/{id}
Детали продукта, условия, состав
/telecom/topup
Создать транзакцию пополнения
/esim/orders
Создать заказ, получить QR-код
/telecom/topup/{tx_id}
Статус транзакции
/webhooks
Регистрация Webhook-адреса
{
"phone": "79161234567"
}{
"phone": "79161234567",
"product_id": "mts_ru_bundle_10gb_30d",
"external_tx_id": "your-tx-901"
}{
"tx_id": "tel_6jn3q...",
"status": "completed",
"operator_tx_id": "MTS-20240315-88123",
"credited": "{ "data_gb": 10, "validity_days": 30 }",
"completed_at": "2024-03-15T16:41:03Z"
}Технические преимущества
Lookup до оплаты
Автоопределение оператора снижает ошибки и показывает только доступные продукты — без лишних шагов для покупателя.
Идемпотентность
external_tx_id защищает от двойного зачисления при повторных запросах после сетевой ошибки.
Operator_tx_id в ответе
Идентификатор транзакции со стороны оператора — позволяет сверить зачисление напрямую при спорах.
Webhook-события
topup.completed, topup.failed, topup.pending — мониторинг каждой транзакции в реальном времени.
Частые вопросы
Зачем вызывать lookup перед пополнением?
Один и тот же номер может принадлежать разным операторам в зависимости от портирования. Lookup определяет актуального оператора и тип абонента (prepaid/postpaid), чтобы показать только совместимые продукты и исключить ошибочные транзакции.
Поддерживаются ли постоплатные (postpaid) номера?
Зависит от оператора. Поле supports в ответе /lookup содержит список доступных типов операций для конкретного номера. Для postpaid обычно доступны только bundle и plan_change, прямое пополнение баланса — только для prepaid.
Что если транзакция зависла в статусе pending?
Некоторые операторы обрабатывают транзакции асинхронно до 5 минут. Статус обновляется через webhook topup.completed / topup.failed. GET /telecom/topup/{tx_id} даёт актуальный статус в любой момент.
Можно ли пополнить номер в другой стране?
Да — международное пополнение является основным сценарием. Передайте номер в международном формате E.164 (+код страны), API автоматически определит страну и оператора.