Интеграция
PayTabs — когда стран Залива больше одной
PayTabs — региональный платёжный шлюз с торговыми аккаунтами сразу в нескольких странах Залива, и поэтому его обычно выбирают те, кто работает больше чем в одной. За Telegram-ботом он живёт как размещённая у провайдера страница оплаты. Каждая страна — отдельный торговый профиль со своими расчётами.
PayTabs — интеграция: доступ, лимиты и доступность
- Модель авторизации
- Ключ API
- Торговые профили
- По одному на страну, у каждого свои учётные данные, валюта и расчёты
- Доступность в Заливе
- В ОАЭ давно и прочно, с расчётами в дирхамах; сильное покрытие Саудовской Аравии
- Поток данных
- 5 переходов, через воркер
As of 2025-10-01, Telegram Bot API 13.4
Зачем нужна эта интеграция
Бизнес, работающий в одной стране, выбирает шлюз по расчётам и по тому, как проходит подключение. Бизнес, работающий в трёх, выбирает по тому, закроет ли одно соглашение все три: держать по шлюзу на страну — значит держать отдельную сверку, отдельные контакты поддержки и отдельные сценарии отказа для того, что покупатель воспринимает как один бренд.
Сильная сторона PayTabs — именно региональное покрытие. Группа с точками в ОАЭ, Саудовской Аравии и Египте может держать профили у одного провайдера, и это заметно упрощает коммерческие отношения, хотя расчёты внизу всё равно остаются страновыми. Последнее важно и постоянно теряется: один провайдер не означает ни один торговый аккаунт, ни одну валюту, ни один цикл расчётов.
Для бота практический вывод такой: страна — полноценное измерение интеграции, а не пункт в конфиге, о котором вспомнили в конце. Какой профиль, какая валюта, какой расчётный счёт и какие местные способы оплаты доступны — всё это определяется тем, откуда покупатель платит, и бот, обслуживающий три страны, обязан правильно маршрутизировать каждую транзакцию, а не сваливаться в тот профиль, который завели первым.
Как на самом деле движутся данные
PayTabs авторизует запросы идентификатором профиля и серверным ключом — своими для каждого торгового профиля. В многострановой схеме это отдельный набор учётных данных на каждую страну: они лежат раздельными секретами воркера и выбираются по определённому рынку. Ошибка в выборе профиля не падает с грохотом — она уводит настоящий платёж на чужой счёт, поэтому выбор делается явно и пишется в лог, а не выводится по умолчанию.
Модель доступа: API-ключ
Их лимиты и что они означают для вас
Каждая страна работает как отдельный торговый профиль со своими учётными данными, валютой и расчётами.
Многострановой бот держит несколько наборов учётных данных и обязан выбирать верный на каждой транзакции. Это самая важная деталь интеграции с PayTabs и та, которую чаще всего принимают за настройку.
Набор местных способов оплаты отличается от страны к стране: mada в Саудовской Аравии, например, доступна далеко не везде.
Оплата, которую видит саудовский покупатель, обоснованно отличается от той, что видит покупатель из ОАЭ. Показывать одинаковый платёжный сценарий на всех рынках — значит показывать худший хотя бы на одном из них.
Валюта и цикл расчётов задаются для каждого профиля в вашем торговом договоре.
Отчётности, которая складывает страны, нужна явная валютная политика. Дашборд, прибавляющий саудовские риалы к дирхамам просто потому, что и то и другое числа, — ошибка из тех, что живут долго, прежде чем кто-то заметит.
Тестовые и боевые учётные данные раздельны для каждого профиля.
На трёх странах это шесть наборов учётных данных. Развёртывание проверяет, что все настроенные профили находятся в одном режиме: частично боевая конфигурация хуже, чем полностью тестовая.
Как это ломается и что происходит потом
Для рынка покупателя выбран не тот торговый профиль.
Платёж успешно уходит на чужой счёт, и ничто не падает с ошибкой. Выбор профиля пишется в лог по каждой транзакции, чтобы сверка поймала это за дни, а не на квартальном разборе.
Серверный обратный вызов приходит более одного раза.
Подтверждение заказа идемпотентно по ссылке на транзакцию. Дублирующиеся вызовы — нормальное поведение шлюза, и они дают двойное исполнение заказа в любой реализации, которая думает иначе.
Платёж прошёл на стороне PayTabs, а обратный вызов до воркера не дошёл.
Задача сверки сама запрашивает статус транзакции по всему, что висит в ожидании дольше порога. Без неё покупатель заплатил, а заказ лежит неисполненным и никому об этом не сигналит.
До оплаты доходит покупатель с неподдерживаемого рынка.
Право рынка на оплату проверяется до создания платежа, а не после. Узнавать об этом на шлюзе — значит получить отказ, который покупатель прочтёт как проблему с картой и запишет на вас.
Доступность в ОАЭ и остальных странах Залива
Объединённые Арабские Эмираты
Давно и прочно, с расчётами в дирхамах на местный счёт. Для бизнеса только в ОАЭ сопоставимо с Telr; PayTabs отрывается именно на многострановом сценарии.
Саудовская Аравия
Сильное покрытие, включая поддержку местной схемы. Для бота на саудовскую аудиторию местный способ оплаты — не приятное дополнение: без него доля доведённых до конца оплат измеримо падает.
Египет, Иордания и другие рынки региона
Покрытие есть и различается. Каждый рынок — отдельный профиль со своим подключением, и каждый стоит подтвердить напрямую, а не вывести из факта присутствия в регионе.
Криптовалюты и виртуальные активы
Не берут в работу, как и обычные карточные шлюзы в целом. Бизнесу на виртуальных активах нужен TON, USDT или другая ончейн-схема, а не карточный процессинг.
Когда эту интеграцию делать не нужно
- Вы работаете ровно в одной стране и расширяться не планируете. Механика с несколькими профилями и есть причина брать PayTabs, а платить за неё вхолостую — просто лишняя сложность.
- У вас нет юрлица на тех рынках, куда вы хотите продавать. Торговый профиль требует местного присутствия, и обслуживать рынок из соседней юрисдикции не получится никак.
- Вы торгуете виртуальными активами. Карточные шлюзы не берут эту категорию, каким бы ни был провайдер.
- Все ваши покупатели сидят в Telegram и берут цифровые товары. Stars сконвертируют лучше и позволят обойтись без торгового аккаунта вообще.
На чём это работает
| Компонент | Версия | Зачем |
|---|---|---|
| Cloudflare Workers | current | Выбор учётных данных по рынку и серверные вызовы шлюза. |
| Cloudflare D1 | current | Заказы с ключом по рынку и записанным выбранным профилем. |
| Zod | 4.4 | Валидация обратных вызовов, которые слегка различаются между профилями. |
| grammY | 1.45 | Передача на оплату и подтверждение с возвратом в переписку. |
Вопросы, которые возникают при оценке
Одно соглашение с PayTabs закрывает все страны Залива?
Коммерческие отношения — одни, торговый аккаунт — нет. Каждая страна это отдельный профиль со своими учётными данными, валютой и расчётами, и бот выбирает между ними на каждой транзакции. Считать это настройкой, а не логикой, — самая частая ошибка здесь.
Чем это отличается от Telr для бизнеса только в ОАЭ?
Почти ничем. Оба рассчитываются в дирхамах на местный счёт и оба берут в работу компании из ОАЭ. Если вы никогда не выйдете за пределы ОАЭ, выбирайте по коммерческим условиям и качеству поддержки, а не по функциям: техническая разница невелика.
Что происходит, если использован профиль не той страны?
Платёж успешно уходит на чужой счёт, и ничто не падает с ошибкой, — поэтому выбор профиля пишется в лог по каждой транзакции. Это тот сбой, который с наибольшей вероятностью останется незамеченным, и именно на него рассчитана сверка.
Стоит ли предлагать местные способы оплаты по каждой стране?
Да. Отсутствие распространённой местной схемы измеримо снижает долю доведённых оплат на этом рынке, а единообразная международная оплата везде означает худшую оплату где-то. Различие платёжного экрана по рынкам здесь сделано намеренно.
Можно ли свести отчётность по всем странам в одну валюту?
Только с явной политикой пересчёта, и её стоит проговорить, а не подразумевать. Отчёт, складывающий саудовские риалы с дирхамами просто потому, что и то и другое числа, — тихая ошибка, способная пережить несколько отчётных циклов.
Сколько занимает подключение торгового профиля?
Считается по каждой стране отдельно, и именно оно, а не разработка, задаёт сроки. Начать подключение по всем рынкам, которые вы собираетесь обслуживать, до заказа бота — самое полезное, что вы можете сделать для графика.
Что почитать дальше
Для бизнеса только в ОАЭ ближе по смыслу сравнение с тем, как устроена интеграция с Telr.
Если расчёты допустимо уводить за пределы региона, стоит прочитать ещё и интеграцию со Stripe.
Работа сразу в нескольких странах обычно сочетает платежи с разбором бота отслеживания доставки.
Типы ботов, за которыми обычно стоит этот шлюз, перечислены в каталоге с ценами.