Журнал
Freedom pay

Freedom Pay в Телеграм: подключение к магазину

Как подключить Freedom Pay (бывший PayBox) к Телеграм-боту: токен в BotFather, магазин, тест и запуск. Для продавцов из Кыргызстана, Казахстана и Узбекистана.

Freedom Pay (раньше PayBox) — платёжная компания из Центральной Азии, которая работает как платёжный провайдер Telegram: покупатель платит картой в платёжном окне самого Telegram, а деньги приходят на ваш мерчант-аккаунт Freedom Pay. Чтобы подключить Freedom Pay к Телеграм-боту, вы берёте токен провайдера у @BotFather и вставляете его в магазин. Этот гайд — для продавцов физических товаров и услуг в Кыргызстане, Казахстане и Узбекистане: от заявки до первого боевого заказа.

Общая картина — в статьях как работают платежи в Telegram и способы оплаты в Telegram. Продаёте в страны Stripe? Вам нужна инструкция по Stripe.

Как работает Freedom Pay в Телеграм#

  1. Покупатель выбирает товар в вашем магазине в Telegram и нажимает «Оплатить».
  2. Открывается платёжное окно Telegram с суммой.
  3. Покупатель вводит карту, Freedom Pay подтверждает платёж (часто кодом, который приходит на телефон покупателя).
  4. Заказ становится оплаченным, деньги поступают на ваш аккаунт Freedom Pay.

С платежей через провайдеров Telegram комиссию не берёт и данные карт не хранит. Списание делает Freedom Pay, а комиссия прописана в вашем договоре.

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

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

Шаг 1 — Откройте мерчант-аккаунт Freedom Pay#

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

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

Шаг 2 — Получите токен провайдера в BotFather#

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

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

  1. В панели откройте Настройки витрины → Заказы и платежи.
  2. В Режиме оформления выберите Платежи Telegram.
Заказы и платежи — выбран режим Платежи Telegram
Заказы и платежи — выбран режим Платежи Telegram
  1. Нажмите Добавить провайдер и заполните:
    • Название провайдера — своя подпись, например Freedom Pay. Готового пункта Freedom Pay в списке нет.
    • Токен провайдера — токен из BotFather.
    • Тестовый режим — включён на время тестов.
Диалог «Добавить провайдер»: название, токен и тестовый режим
Диалог «Добавить провайдер»: название, токен и тестовый режим
  1. Нажмите Сохранить провайдер. В строке появятся отметки Тестовый режим и Активен и кнопки Редактировать провайдер и Удалить провайдер.
Сохранённый провайдер Freedom Pay с отметками «Тестовый режим» и «Активен»
Сохранённый провайдер Freedom Pay с отметками «Тестовый режим» и «Активен»
  1. Поставьте Валюту магазина, которую Freedom Pay подтвердил для вашего аккаунта.
  2. Откройте Оформление заказа → Способы оплаты и убедитесь, что в списке есть Счёт Telegram. Если нет — нажмите Добавить способ и добавьте его.

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

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

ПолеТестовое значение
Карта4111 1111 1111 1111
Срок12/24 (2024/12 в документации Freedom Pay)
CVV123
Держательминимум два слова латиницей (например, Test User)
3-DS (если спросят)12345678

Если срок отклоняют как прошедший, сверьтесь с актуальным списком тестовых карт или попросите у поддержки Freedom Pay новую тестовую дату.

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

  1. Подпишите договор и акт подключения, чтобы аккаунт Freedom Pay перешёл в боевой режим.
  2. Возьмите боевой токен в BotFather → Payments.
  3. В Tiny Shops нажмите Редактировать провайдер, вставьте боевой токен, выключите Тестовый режим и нажмите Сохранить провайдер.
  4. Проверьте, что строка по-прежнему Активен, уже без тестового режима.
  5. Сделайте небольшой реальный заказ и убедитесь, что деньги пришли во 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 — для физических товаров и услуг.

Источники#

Откройте магазин и подключите Freedom Pay на tiny-shops.com →

Читать дальше

Оплата в телеграм

Оплата переводом в Telegram-магазине: реквизиты и подтверждение в один тап

Покажите покупателю реквизиты карты, счёта или кошелька, попросите подтверждение оплаты и подтвердите перевод кнопкой в Telegram. Пошаговая инструкция.

Канал

Новые статьи — сначала в Telegram.
Без спама и «лайфхаков роста».