Freedom Pay (раньше PayBox) — платёжная компания из Центральной Азии, которая работает как платёжный провайдер Telegram: покупатель платит картой в платёжном окне самого Telegram, а деньги приходят на ваш мерчант-аккаунт Freedom Pay. Чтобы подключить Freedom Pay к Телеграм-боту, вы берёте токен провайдера у @BotFather и вставляете его в магазин. Этот гайд — для продавцов физических товаров и услуг в Кыргызстане, Казахстане и Узбекистане: от заявки до первого боевого заказа.
Общая картина — в статьях как работают платежи в Telegram и способы оплаты в Telegram. Продаёте в страны Stripe? Вам нужна инструкция по Stripe.
Как работает Freedom Pay в Телеграм#
- Покупатель выбирает товар в вашем магазине в Telegram и нажимает «Оплатить».
- Открывается платёжное окно Telegram с суммой.
- Покупатель вводит карту, Freedom Pay подтверждает платёж (часто кодом, который приходит на телефон покупателя).
- Заказ становится оплаченным, деньги поступают на ваш аккаунт Freedom Pay.
С платежей через провайдеров Telegram комиссию не берёт и данные карт не хранит. Списание делает Freedom Pay, а комиссия прописана в вашем договоре.
Что понадобится#
- Telegram-бот, подключённый к магазину на Tiny Shops.
- Мерчант-аккаунт Freedom Pay на юрлицо вашей страны (анкета KG или сайты KZ / UZ, если юрлицо там).
- Документы компании для проверки и, для боевых платежей, подписанный договор подключения с Freedom Pay.
Шаг 1 — Откройте мерчант-аккаунт Freedom Pay#
- Оставьте заявку (KG: freedompay.kg/anketa).
- Заполните анкету и приложите документы, которые запросят. Новые мерчанты обычно стартуют в тестовом режиме; в боевой Freedom Pay переводит после тестов и подписания акта подключения.
- В личном кабинете найдите ID магазина / аккаунта. Берите ID из своего кабинета.
Уточните у менеджера Freedom Pay три вещи: включены ли для вас платежи в Telegram-ботах, в каких валютах можно выставлять счета (для KG обычно KGS) и какая комиссия по договору.
Шаг 2 — Получите токен провайдера в BotFather#
- Откройте @BotFather →
/mybots→ бот магазина. - Нажмите Bot Settings → Payments.
- Выберите пункт Freedom Pay для вашей страны. В зависимости от аккаунта это может быть FreedomPay KG, FreedomPay KZ, FreedomPay UZ или старый PayBox.money. Ориентируйтесь на ту подпись, которую показывает BotFather.
- Пройдите подключение в боте Freedom Pay (обычно ID магазина и несколько полей).
- Сначала скопируйте тестовый токен. После перевода в боевой режим BotFather выдаст боевой токен.
Шаг 3 — Вставьте токен в Tiny Shops#
- В панели откройте Настройки витрины → Заказы и платежи.
- В Режиме оформления выберите Платежи Telegram.

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

- Нажмите Сохранить провайдер. В строке появятся отметки Тестовый режим и Активен и кнопки Редактировать провайдер и Удалить провайдер.

- Поставьте Валюту магазина, которую Freedom Pay подтвердил для вашего аккаунта.
- Откройте Оформление заказа → Способы оплаты и убедитесь, что в списке есть Счёт Telegram. Если нет — нажмите Добавить способ и добавьте его.
Шаг 4 — Тестовый заказ#
Оформите заказ в магазине тестовой картой из документации Freedom Pay (Merchant API):
| Поле | Тестовое значение |
|---|---|
| Карта | 4111 1111 1111 1111 |
| Срок | 12/24 (2024/12 в документации Freedom Pay) |
| CVV | 123 |
| Держатель | минимум два слова латиницей (например, Test User) |
| 3-DS (если спросят) | 12345678 |
Если срок отклоняют как прошедший, сверьтесь с актуальным списком тестовых карт или попросите у поддержки Freedom Pay новую тестовую дату.
Шаг 5 — Боевой режим#
- Подпишите договор и акт подключения, чтобы аккаунт Freedom Pay перешёл в боевой режим.
- Возьмите боевой токен в BotFather → Payments.
- В Tiny Shops нажмите Редактировать провайдер, вставьте боевой токен, выключите Тестовый режим и нажмите Сохранить провайдер.
- Проверьте, что строка по-прежнему Активен, уже без тестового режима.
- Сделайте небольшой реальный заказ и убедитесь, что деньги пришли во Freedom Pay.
Перед запуском пройдите и чек-лист Telegram: двухэтапная проверка на аккаунте владельца бота, команды /terms и /support, готовность разбирать споры.
Физические товары и цифровые (Stars)#
Freedom Pay — для физических товаров и услуг. Цифровые товары и услуги внутри Telegram оплачиваются только в Telegram Stars (XTR): Telegram предупреждает, что не сможет показывать мобильным пользователям бота или Mini App, которые продают цифровое через сторонних провайдеров. Подробнее — в статье Telegram Stars или Stripe.
Комиссии и валюта#
- Telegram: с платежей через провайдеров комиссии нет.
- Freedom Pay: задаётся индивидуально в договоре (процент, фиксированная сумма или оба). Уточните у менеджера или посмотрите договор.
- Tiny Shops: процент тарифа с каждого заказа — 7% на Free, 3% на Starter ($9,99 в месяц), 1,5% на Pro ($29), 0,7% на Scale ($79). Первые $100 продаж аккаунта — без комиссии, один раз, а не каждый месяц. Он списывается вместе с тарифом, а не удерживается из платежа Freedom Pay. Подробнее — на странице тарифов.
- Валюта: подтвердите её у Freedom Pay. В Кыргызстане обычно KGS; KZT и UZS зависят от вашего подключения.
Частые вопросы#
Freedom Pay и PayBox — это одно и то же? Да, Freedom Pay — бывший PayBox.money. В BotFather рядом с FreedomPay KG, KZ или UZ может оставаться пункт PayBox.money — выбирайте тот, что для вашей страны.
Как подключить Freedom Pay к Телеграм-боту без кода? BotFather → Bot Settings → Payments → пункт Freedom Pay вашей страны → токен → в Tiny Shops Настройки витрины → Заказы и платежи → Платежи Telegram → Добавить провайдер.
Нужен ли Merchant API Freedom Pay? Нет. Для платежей в Telegram нужен только токен провайдера из BotFather. Merchant API — отдельная интеграция для сайтов.
Почему платёж падает с ошибкой PAYMENT_PROVIDER_INVALID?
Обычно из-за валюты. Поставьте Валюту магазина, которую Freedom Pay поддерживает для вашего подключения к Telegram.
Можно ли продавать цифровые товары через Freedom Pay в Telegram? Нет. Для цифрового используйте Telegram Stars, Freedom Pay — для физических товаров и услуг.
Источники#
- Telegram Bot Payments
- Telegram Stars для цифровых товаров
- Freedom Pay KG — платежи в Telegram · EN
- Анкета мерчанта Freedom Pay KG
- Merchant API Freedom Pay (тестовые карты)
- Документация Tiny Shops: Telegram Payments
Откройте магазин и подключите Freedom Pay на tiny-shops.com →
- 🇷🇺 Tiny Shops RU
- 🇬🇧 Tiny Shops EN
