Как подключить Freedom Pay к Telegram-магазину

Tiny Shops — конструктор магазинов в Telegram Mini App без кода. Freedom Pay (раньше PayBox) — платёжная компания для Центральной Азии: вы подключаете её как провайдера Telegram Payments, берёте токен провайдера у @BotFather и вставляете в Tiny Shops. Отдельной кнопки «Freedom Pay» в панели нет — любой токен BotFather работает одинаково. Название Freedom Pay вы сами пишете в поле Название провайдера.

Этот гайд — для продавцов в Кыргызстане (KG), Казахстане (KZ) и Узбекистане (UZ) с физическими товарами и услугами. Обзор Stars, Stripe, крипты и других способов — в как принимать оплату в Telegram. Если аудитория в странах Stripe — соседняя инструкция как подключить Stripe (на английском), а выбор рельсов — в правилах Stripe vs Stars.

Что понадобится#

1. Telegram-бот, привязанный к магазину на Tiny Shops
2. Мерчант-аккаунт Freedom Pay под вашу юрисдикцию (анкета KG или сайты KZ / UZ, если юрлицо там)
3. KYC / документы компании и для боевых платежей — подписанный договор подключения с Freedom Pay

Шаг 1 — Аккаунт Freedom Pay и ID магазина#

1. Оставьте заявку на Freedom Pay (KG: freedompay.kg/anketa или EN anketa).
2. Заполните анкету и документы. Новые мерчанты обычно стартуют в тестовом режиме; в прод Freedom Pay переводит после тестов и акта подключения.
3. В личном кабинете найдите ID магазина / аккаунта (merchant / store ID). Пример формата: 545158 — берите ID из своего кабинета, не этот номер.

Уточните у менеджера Freedom Pay: доступность Telegram Bot Payments, валюты инвойсов (для KG часто KGS — подтвердите) и комиссию по договору.

Шаг 2 — Токен провайдера в BotFather#

1. Откройте @BotFather → /mybots → бот вашего магазина Tiny Shops.
2. Bot Settings → Payments.
3. Выберите FreedomPay KG (для Кыргызстана). В списке также могут быть FreedomPay KZ, FreedomPay UZ или устаревший PayBox.money — смотрите точную подпись в интерфейсе BotFather; не выдумывайте название, которого нет в списке.
4. Пройдите онбординг в боте Freedom Pay (обычно вводите ID магазина и поля, которые они запросят).
5. Сначала скопируйте тестовый токен. После выхода в бой BotFather покажет LIVE-токен (часто с :LIVE: — проверьте в UI).

Telegram карты не обрабатывает и комиссию с платежей сторонних провайдеров не берёт — эквайринг у Freedom Pay.

Шаг 3 — Вставьте токен в Tiny Shops#

1. Панель → Настройки витрины → Заказы и платежи.
2. Режим Платежи Telegram.

Режим Платежи Telegram — кнопка «Добавить провайдер» на этом экране.

3. Нажмите Добавить провайдер и заполните:
   • Название провайдера — своя подпись, например Freedom Pay (готового пункта Freedom Pay в Tiny Shops нет)
   • Токен провайдера — из BotFather
   • Тестовый режим — включён на время тестов

Добавить провайдер — название, токен BotFather и тестовый режим.

4. Нажмите Сохранить провайдер.
5. Убедитесь, что в сохранённой строке стоят бейджи Активен (и Тестовый режим, пока тестируете). У строки провайдера есть Изменить / Удалить — кнопки Сделать по умолчанию в списке провайдеров Telegram Payments нет. Если магазин также использует способы оплаты формы Checkout, По умолчанию живёт там, а не в этом списке.

После сохранения — строка Freedom Pay с Test Mode и Active; Edit / Delete в строке.

6. Валюту магазина выставьте ту, которую подтвердил Freedom Pay для вашего аккаунта.

Путь и поля в документации: Telegram Payments.

Шаг 4 — Тестовый заказ#

В Mini App оформите заказ тестовой картой из документации Freedom Pay (Merchant API):

Если срок 12/24 отклонят как прошедший — сверьтесь с актуальным списком тест-карт: там по-прежнему указано 2024/12 (на сентябрь 2026). Если нужна новая дата — уточните у поддержки Freedom Pay.

Шаг 5 — Боевой режим (LIVE)#

1. Закройте договор / акт подключения — аккаунт Freedom Pay в продакшене.
2. Возьмите LIVE-токен в BotFather → Payments.
3. В Tiny Shops замените токен у сохранённого провайдера, выключите Тестовый режим, нажмите Сохранить провайдер.
4. Проверьте, что строка по-прежнему Активен (без тестового режима). Для Telegram Payments этого достаточно — отдельной кнопки «Сделать по умолчанию» в списке провайдеров нет.
5. Проведите маленький реальный заказ и сверьте расчёт с Freedom Pay.

Физические товары vs цифровые (Stars)#

На мобильных нельзя предлагать сторонний карточный чекаут для цифровых товаров внутри Telegram. Смешанный каталог: Stars для цифровых SKU, Freedom Pay — для физических.

Комиссии и валюта#

• Telegram не берёт комиссию с платежей сторонних провайдеров.
• Tiny Shops не берёт долю платформы с платежа.
• Комиссия Freedom Pay задаётся индивидуально в договоре (%, фикс или комбинация). Не публикуйте «среднюю» ставку с потолка — спросите менеджера или смотрите договор.
• Валюты инвойсов подтверждайте у Freedom Pay. В онбординге KG часто фигурирует KGS; в таблице Telegram есть и KZT, и UZS, но поддержка у провайдера — отдельно.

FAQ#

Freedom Pay и PayBox — это одно и то же?
Да, ребрендинг с PayBox.money. В BotFather рядом с FreedomPay KG / KZ / UZ иногда остаётся PayBox.money — выбирайте подпись под вашу страну.

Нужен ли Merchant API Freedom Pay (init_payment, подписи)?
Для Telegram Payments в Tiny Shops — нет. Достаточно токена провайдера из BotFather. Gateway API — отдельный путь интеграции.

Как подключить Freedom Pay к Telegram боту без кода?
BotFather → Payments → FreedomPay KG (или KZ/UZ) → токен → Настройки витрины → Заказы и платежи → Платежи Telegram → Добавить провайдер.

Ошибка PAYMENT_PROVIDER_INVALID?
Чаще всего несовпадение валюты. Выровняйте валюту магазина с тем, что поддерживает Freedom Pay для Telegram-подключения.

Можно ли Freedom Pay для цифровых загрузок на телефоне?
Для цифрового на мобильных — Stars (XTR). Токен Freedom Pay — для физических товаров и услуг.

Есть ли в Tiny Shops готовый пункт «Freedom Pay»?
Нет. Добавляете обычного провайдера и сами пишете Freedom Pay в Название провайдера.

Где платит покупатель?
В нативном платёжном окне Telegram после чекаута в Mini App — как у других провайдеров BotFather.

Источники и дальше читать#

• Telegram Bot Payments (физические товары)
• Telegram Stars / цифровые товары
• Freedom Pay KG — оплата в Telegram · EN
• Анкета мерчанта Freedom Pay KG
• Merchant API intro (тест-карты)
• Документация Tiny Shops — Telegram Payments
• Как принимать оплату в Telegram (все способы)
• Как подключить Stripe к Telegram-магазину (EN)
• Stripe vs Stars для чекаута в Telegram
• Тарифы Tiny Shops

Создайте или откройте магазин на tiny-shops.com — или сразу в конструктор Telegram-магазинов →

• 🇷🇺 Tiny Shops RU
• 🇬🇧 Tiny Shops EN