Telegraft

Интеграция

PayTabs — когда стран Залива больше одной

PayTabs — региональный платёжный шлюз с торговыми аккаунтами сразу в нескольких странах Залива, и поэтому его обычно выбирают те, кто работает больше чем в одной. За Telegram-ботом он живёт как размещённая у провайдера страница оплаты. Каждая страна — отдельный торговый профиль со своими расчётами.

PayTabs — интеграция: доступ, лимиты и доступность

Модель авторизации
Ключ API
Торговые профили
По одному на страну, у каждого свои учётные данные, валюта и расчёты
Доступность в Заливе
В ОАЭ давно и прочно, с расчётами в дирхамах; сильное покрытие Саудовской Аравии
Поток данных
5 переходов, через воркер

As of 2025-10-01, Telegram Bot API 13.4

Зачем нужна эта интеграция

Бизнес, работающий в одной стране, выбирает шлюз по расчётам и по тому, как проходит подключение. Бизнес, работающий в трёх, выбирает по тому, закроет ли одно соглашение все три: держать по шлюзу на страну — значит держать отдельную сверку, отдельные контакты поддержки и отдельные сценарии отказа для того, что покупатель воспринимает как один бренд.

Сильная сторона PayTabs — именно региональное покрытие. Группа с точками в ОАЭ, Саудовской Аравии и Египте может держать профили у одного провайдера, и это заметно упрощает коммерческие отношения, хотя расчёты внизу всё равно остаются страновыми. Последнее важно и постоянно теряется: один провайдер не означает ни один торговый аккаунт, ни одну валюту, ни один цикл расчётов.

Для бота практический вывод такой: страна — полноценное измерение интеграции, а не пункт в конфиге, о котором вспомнили в конце. Какой профиль, какая валюта, какой расчётный счёт и какие местные способы оплаты доступны — всё это определяется тем, откуда покупатель платит, и бот, обслуживающий три страны, обязан правильно маршрутизировать каждую транзакцию, а не сваливаться в тот профиль, который завели первым.

Как на самом деле движутся данные

Покупательв Telegramзаказ и рынокВоркер ботасоздание платежаПрофильPayTabsсерверный обратный вызовВоркер ботаподтверждениеЗаписьзаказа в D1
Рынок покупателя определяется до создания платежа, потому что именно он выбирает торговый профиль, валюту и расчётный счёт. Подтверждение приходит серверным обратным вызовом и никогда — редиректом в браузере.

PayTabs авторизует запросы идентификатором профиля и серверным ключом — своими для каждого торгового профиля. В многострановой схеме это отдельный набор учётных данных на каждую страну: они лежат раздельными секретами воркера и выбираются по определённому рынку. Ошибка в выборе профиля не падает с грохотом — она уводит настоящий платёж на чужой счёт, поэтому выбор делается явно и пишется в лог, а не выводится по умолчанию.

Модель доступа: API-ключ

Их лимиты и что они означают для вас

Каждая страна работает как отдельный торговый профиль со своими учётными данными, валютой и расчётами.

Многострановой бот держит несколько наборов учётных данных и обязан выбирать верный на каждой транзакции. Это самая важная деталь интеграции с PayTabs и та, которую чаще всего принимают за настройку.

Набор местных способов оплаты отличается от страны к стране: mada в Саудовской Аравии, например, доступна далеко не везде.

Оплата, которую видит саудовский покупатель, обоснованно отличается от той, что видит покупатель из ОАЭ. Показывать одинаковый платёжный сценарий на всех рынках — значит показывать худший хотя бы на одном из них.

Валюта и цикл расчётов задаются для каждого профиля в вашем торговом договоре.

Отчётности, которая складывает страны, нужна явная валютная политика. Дашборд, прибавляющий саудовские риалы к дирхамам просто потому, что и то и другое числа, — ошибка из тех, что живут долго, прежде чем кто-то заметит.

Тестовые и боевые учётные данные раздельны для каждого профиля.

На трёх странах это шесть наборов учётных данных. Развёртывание проверяет, что все настроенные профили находятся в одном режиме: частично боевая конфигурация хуже, чем полностью тестовая.

Как это ломается и что происходит потом

Для рынка покупателя выбран не тот торговый профиль.

Платёж успешно уходит на чужой счёт, и ничто не падает с ошибкой. Выбор профиля пишется в лог по каждой транзакции, чтобы сверка поймала это за дни, а не на квартальном разборе.

Серверный обратный вызов приходит более одного раза.

Подтверждение заказа идемпотентно по ссылке на транзакцию. Дублирующиеся вызовы — нормальное поведение шлюза, и они дают двойное исполнение заказа в любой реализации, которая думает иначе.

Платёж прошёл на стороне PayTabs, а обратный вызов до воркера не дошёл.

Задача сверки сама запрашивает статус транзакции по всему, что висит в ожидании дольше порога. Без неё покупатель заплатил, а заказ лежит неисполненным и никому об этом не сигналит.

До оплаты доходит покупатель с неподдерживаемого рынка.

Право рынка на оплату проверяется до создания платежа, а не после. Узнавать об этом на шлюзе — значит получить отказ, который покупатель прочтёт как проблему с картой и запишет на вас.

Доступность в ОАЭ и остальных странах Залива

Объединённые Арабские Эмираты

Давно и прочно, с расчётами в дирхамах на местный счёт. Для бизнеса только в ОАЭ сопоставимо с Telr; PayTabs отрывается именно на многострановом сценарии.

Саудовская Аравия

Сильное покрытие, включая поддержку местной схемы. Для бота на саудовскую аудиторию местный способ оплаты — не приятное дополнение: без него доля доведённых до конца оплат измеримо падает.

Египет, Иордания и другие рынки региона

Покрытие есть и различается. Каждый рынок — отдельный профиль со своим подключением, и каждый стоит подтвердить напрямую, а не вывести из факта присутствия в регионе.

Криптовалюты и виртуальные активы

Не берут в работу, как и обычные карточные шлюзы в целом. Бизнесу на виртуальных активах нужен TON, USDT или другая ончейн-схема, а не карточный процессинг.

Когда эту интеграцию делать не нужно

  • Вы работаете ровно в одной стране и расширяться не планируете. Механика с несколькими профилями и есть причина брать PayTabs, а платить за неё вхолостую — просто лишняя сложность.
  • У вас нет юрлица на тех рынках, куда вы хотите продавать. Торговый профиль требует местного присутствия, и обслуживать рынок из соседней юрисдикции не получится никак.
  • Вы торгуете виртуальными активами. Карточные шлюзы не берут эту категорию, каким бы ни был провайдер.
  • Все ваши покупатели сидят в Telegram и берут цифровые товары. Stars сконвертируют лучше и позволят обойтись без торгового аккаунта вообще.

На чём это работает

КомпонентВерсияЗачем
Cloudflare WorkerscurrentВыбор учётных данных по рынку и серверные вызовы шлюза.
Cloudflare D1currentЗаказы с ключом по рынку и записанным выбранным профилем.
Zod4.4Валидация обратных вызовов, которые слегка различаются между профилями.
grammY1.45Передача на оплату и подтверждение с возвратом в переписку.

Вопросы, которые возникают при оценке

Одно соглашение с PayTabs закрывает все страны Залива?

Коммерческие отношения — одни, торговый аккаунт — нет. Каждая страна это отдельный профиль со своими учётными данными, валютой и расчётами, и бот выбирает между ними на каждой транзакции. Считать это настройкой, а не логикой, — самая частая ошибка здесь.

Чем это отличается от Telr для бизнеса только в ОАЭ?

Почти ничем. Оба рассчитываются в дирхамах на местный счёт и оба берут в работу компании из ОАЭ. Если вы никогда не выйдете за пределы ОАЭ, выбирайте по коммерческим условиям и качеству поддержки, а не по функциям: техническая разница невелика.

Что происходит, если использован профиль не той страны?

Платёж успешно уходит на чужой счёт, и ничто не падает с ошибкой, — поэтому выбор профиля пишется в лог по каждой транзакции. Это тот сбой, который с наибольшей вероятностью останется незамеченным, и именно на него рассчитана сверка.

Стоит ли предлагать местные способы оплаты по каждой стране?

Да. Отсутствие распространённой местной схемы измеримо снижает долю доведённых оплат на этом рынке, а единообразная международная оплата везде означает худшую оплату где-то. Различие платёжного экрана по рынкам здесь сделано намеренно.

Можно ли свести отчётность по всем странам в одну валюту?

Только с явной политикой пересчёта, и её стоит проговорить, а не подразумевать. Отчёт, складывающий саудовские риалы с дирхамами просто потому, что и то и другое числа, — тихая ошибка, способная пережить несколько отчётных циклов.

Сколько занимает подключение торгового профиля?

Считается по каждой стране отдельно, и именно оно, а не разработка, задаёт сроки. Начать подключение по всем рынкам, которые вы собираетесь обслуживать, до заказа бота — самое полезное, что вы можете сделать для графика.

Что почитать дальше