Интеграция
Network International — для тех, у кого банк уже есть
Network International — крупный региональный эквайер, которым пользуются состоявшиеся мерчанты ОАЭ, часто параллельно с уже действующими отношениями с банком. За Telegram-ботом он работает как размещённая у провайдера страница оплаты. Отношения здесь корпоративного размера: подключение тяжелее, чем у шлюза, а коммерческие условия обсуждаются индивидуально.
Network International — интеграция: доступ, лимиты и доступность
- Модель авторизации
- OAuth 2.0
- Токены
- Короткоживущие; обновляются потоком client credentials
- Доступность в Заливе
- ОАЭ — основной рынок, с глубокими связями с местными банками
- Поток данных
- 5 переходов, через воркер
As of 2025-10-01, Telegram Bot API 13.4
Зачем нужна эта интеграция
Бизнес, который до этого доходит, редко выбирает процессинг с чистого листа. Он уже принимает карты в офлайне, у него уже есть терминалы и договор эквайринга, а онлайн-канал добавляется к тому, что уже работает. В такой ситуации один эквайер на оба канала означает одну сверку, один набор коммерческих условий и одни отношения с поддержкой, и операционно это стоит больше, чем любая разница в API.
От этого меняется форма самого проекта. У шлюза, рассчитанного на малых мерчантов, работа — это интеграция, а подключение — анкета. У эквайера такого размера в подключении участвуют менеджеры, техническая сертификация и график, который принадлежит не вам. Инженерия не становится сложнее; сложнее становится согласование, и план, считающий это двухнедельной задачей по API, промахнётся по срокам в разы.
Взамен вы получаете отношения с реальным весом. Бизнесу, который проводит значимые объёмы и в офлайне, и онлайне, один эквайер, видящий оба канала и способный обсуждать условия по целому, даёт позицию сильнее, чем набор шлюзов по каналам. Бизнесу, который до такого масштаба ещё не дорос, это накладные расходы без выгоды.
Как на самом деле движутся данные
Доступ выдаётся через обмен по схеме client credentials в OAuth, на выходе — короткоживущий токен, который кэшируется в воркере и обновляется заранее, до истечения, а не по факту сбоя. Обновление постфактум означает, что первый запрос после каждого истечения падает, а под нагрузкой это ровный ручеёк ошибок, которых можно было избежать, — выглядит он как ненадёжный шлюз.
Модель доступа: OAuth 2.0
Их лимиты и что они означают для вас
Токены доступа короткоживущие и должны обновляться через поток client credentials.
Токены кэшируются и обновляются заранее, до истечения. Обновление по первому сбою гарантирует один провалившийся платёж покупателя на каждое окно истечения — регулярная ошибка, нанесённая самому себе.
До выдачи доступа к боевой среде требуется техническая сертификация.
Между работающей интеграцией и работающим приёмом платежей стоит шаг согласования, которым распоряжается график эквайера. Заложить его в план — и есть разница между датой запуска и надеждой на запуск.
Коммерческие условия, включая ставки и расчёты, обсуждаются индивидуально с мерчантом, а не публикуются.
Стоимость нельзя прикинуть по открытому прайсу. Это разговор с менеджером, и вести его надо до технического решения, а не после.
Поведение песочницы в краевых случаях может отличаться от боевого, особенно вокруг 3-D Secure.
Отчасти ради этого сертификация и существует. Закладывайте цикл проверок в боевом режиме на настоящих мелких транзакциях, а не рассчитывайте на совпадение с песочницей.
Как это ломается и что происходит потом
Закэшированный токен доступа истекает посреди запроса.
Запрос один раз повторяется со свежим токеном, а не выдаёт ошибку наружу. Одно истечение никогда не должно доходить до покупателя как неудавшийся платёж.
3-D Secure прерывает оплату, и покупатель бросает её прямо на проверке.
Заказ остаётся в ожидании и истекает по таймеру, освобождая всё, что удерживал. Здесь это случается чаще, чем в шлюзах под массового покупателя, потому что проверка тут заметно чаще обязательна.
Приходит webhook по заказу, о котором у воркера нет записи.
Пишется в лог и эскалируется, а не игнорируется. Обычно это значит, что заказ создали не в той среде, и найти это стоит сразу, а не на сверке.
Отчёт о расчётах расходится с записями заказов у бота.
Ежедневная сверка сравнивает их и поднимает тревогу при расхождении. С эквайером такого размера достоверен файл расчётов, поэтому задача бота — быстро заметить несогласие.
Доступность в ОАЭ и остальных странах Залива
Объединённые Арабские Эмираты
Основной рынок с глубокими связями с банками. Естественный выбор для состоявшегося мерчанта, который уже проводит эквайринг через банк в ОАЭ.
Ближний Восток и Африка в целом
Значительное присутствие в регионе, при этом условия и возможности различаются по странам. Каждый рынок — отдельный коммерческий разговор.
Малый бизнес и стартапы
Как правило, плохо подходит. Накладные расходы на подключение и сертификацию рассчитаны на устоявшиеся объёмы, и бизнесу поменьше лучше послужат Telr или PayTabs.
Криптовалюты и виртуальные активы
Не берут в работу, как и карточные эквайеры в целом. Бизнесу на виртуальных активах нужна ончейн-схема.
Когда эту интеграцию делать не нужно
- Вы малый или новый мерчант. Накладные расходы на подключение и сертификацию съедят проект, а шлюз, рассчитанный на ваш размер, выведет вас в боевой режим на месяцы раньше.
- Вам нужно запуститься быстро. Шагом сертификации распоряжается график эквайера, и никакая инженерная спешка его не двигает.
- У вас нет действующих отношений с банком или эквайером. Главное преимущество здесь — объединить те, что уже есть.
- Вы торгуете виртуальными активами. Не берут в работу, как и карточные эквайеры в целом.
На чём это работает
| Компонент | Версия | Зачем |
|---|---|---|
| Cloudflare Workers | current | Кэширование токена, создание заказов и обработка webhook. |
| Cloudflare KV | current | Кэш токена доступа, общий для всех вызовов воркера. |
| Cloudflare D1 | current | Заказы, состояние сверки расчётов и журнал расхождений. |
| Zod | 4.4 | Валидация ответов на запрос токена и тел webhook. |
Вопросы, которые возникают при оценке
Когда Network International оказывается правильнее шлюза?
Когда вы уже проводите эквайринг через банк ОАЭ по офлайновым каналам и хотите одни отношения на оба. Преимущество тут коммерческое и операционное, а не техническое, и на объёмах оно вполне реально.
Что такое техническая сертификация и сколько она занимает?
Шаг согласования, на котором эквайер проверяет, что ваша интеграция ведёт себя корректно, и только потом открывает боевой доступ. Длительность принадлежит их графику, а не вашему, поэтому в плане она стоит как зависимость, а не как задача.
Зачем кэшировать токен доступа, а не запрашивать его на каждый запрос?
Потому что обмен токена на каждом платеже добавляет задержку на критическом пути покупателя и множит объём ваших запросов без всякой пользы. Токен кэшируется и обновляется до истечения, поэтому его никто из покупателей не ждёт.
Обязателен ли здесь 3-D Secure?
Чаще, чем в шлюзах под массового покупателя, и на долю доведённых оплат это влияет ощутимо. Оплата проектируется в расчёте на проверку, а не так, будто она исключение: проектирование вокруг счастливого пути делает частый случай похожим на поломку.
Как свести заказы с отчётом о расчётах?
Ежедневная задача сравнивает файл расчётов с записями заказов бота и поднимает тревогу при любом расхождении. Достоверен файл расчётов, поэтому задача бота — заметить несогласие за дни, а не на квартальном разборе.
Можно ли оценить стоимость до разговора с ними?
Сколько-нибудь полезно — нет. Ставки обсуждаются индивидуально с мерчантом и не публикуются, поэтому коммерческий разговор должен предшествовать техническому решению, а не следовать за ним.
Что почитать дальше
Мерчанту поменьше, у которого нет действующего договора эквайринга, стоит начать с интеграции с Telr.
Если задействовано несколько стран Залива, сравните с интеграцией с PayTabs.
Сценарии с депозитами, зависящие от холдов авторизации, описаны в разборе бота аренды авто.
Накладные расходы на сертификацию — реальная статья затрат, о ней речь в том, как платёжная интеграция влияет на цену.