Первый вопрос: что вы продаёте
Способ приёма оплаты определяется не технологией, а товаром. Магазины приложений и Telegram разделяют две большие группы:
- Физические товары и услуги вне приложения: одежда, еда, доставка, запись к мастеру, билеты на офлайн-события.
- Цифровые товары и подписки внутри приложения: доступ к контенту, премиум-функции, внутриигровая валюта, цифровые уроки.
Для первой группы обычно подходит обычный эквайринг. Для второй магазины приложений, как правило, требуют использовать собственные платёжные механизмы, а у Telegram для цифровых товаров в Mini Apps есть собственная валюта Telegram Stars. Правила меняются, поэтому перед проектированием сверьтесь с актуальными руководствами каждой платформы.
Основные способы оплаты
| Способ | Подходит для | Особенности | |---|---|---| | Эквайринг (банк, платёжный агрегатор) | Физические товары, услуги | Нужен договор, комиссия, интеграция по API | | Встроенные покупки магазина (IAP) | Цифровые товары в приложении | Комиссия магазина, правила возвратов от платформы | | Платежи Telegram | Боты и Mini Apps | Подключение платёжного провайдера через бота | | Telegram Stars | Цифровые товары в Telegram | Внутренняя валюта платформы | | Системные кошельки (Apple Pay, Google Pay) | Быстрая оплата картой | Упрощают ввод, работают поверх эквайринга | | Оплата по ссылке или счёту | B2B, нерегулярные платежи | Минимум интеграции |
Доступность конкретных провайдеров зависит от юрисдикции и вашего юрлица, поэтому первый шаг — выбор провайдера, который работает с вашим бизнесом.
Как устроена оплата в Mini App
В Mini App оплату можно организовать двумя способами. Первый — открыть платёжную страницу провайдера и вернуть пользователя в приложение. Второй — выставить счёт через бота: пользователь видит стандартное окно оплаты Telegram, подтверждает платёж, а бот получает уведомление об успехе. Второй вариант короче для клиента, потому что не требует вводить данные на постороннем сайте.
Главное правило: факт оплаты подтверждается только на сервере. Ответ из интерфейса приложения подделать легко, поэтому доступ к заказу или контенту выдаётся после подтверждения от платёжной системы.
Надёжный сценарий оплаты
- Клиент оформляет заказ, сервер создаёт его в статусе «ожидает оплаты».
- Приложение запрашивает у сервера платёжную ссылку или счёт.
- Клиент оплачивает.
- Платёжная система присылает серверу уведомление (вебхук).
- Сервер проверяет подпись уведомления, меняет статус заказа и только затем открывает доступ.
- Клиенту приходит подтверждение, например сообщение в боте или push.
Обязательные детали, которые забывают
- Идемпотентность. Вебхук может прийти дважды; повторная обработка не должна дублировать заказ.
- Таймаут и отмена. Что происходит, если клиент ушёл со страницы оплаты? Заказ не должен «висеть» бесконечно.
- Возвраты. Продумайте процесс заранее: кто решает, как возвращаются деньги, как меняется статус.
- Чеки. Для российского бизнеса продажи обычно требуют фискальных чеков; уточните у бухгалтера и провайдера, кто их формирует.
- Тестовый режим. Прогоните успех, отказ, повтор, частичный возврат на тестовых данных до запуска.
Подписки
Подписка добавляет сложности: периодические списания, неуспешные платежи, отмена, смена тарифа. Для цифровых подписок в приложениях из магазинов обычно задействуют механизм подписок магазина, который сам ведёт продления и отмены. В Telegram и на сайте вы отвечаете за это сами или через провайдера с поддержкой рекуррентных платежей. Выбирайте решение до проектирования интерфейса, потому что от него зависят тексты, экраны управления подпиской и сроки.
Безопасность
Не храните данные карт у себя: пользуйтесь токенизацией провайдера, чтобы работать только с токеном. Храните ключи и секреты на сервере, а не в приложении. Логируйте события платежей для разбора спорных случаев, но без чувствительных данных.
Условный пример: стоимость комиссий
Допустим, провайдер берёт условные 3% с платежа, а средний чек — 2 000 рублей. Тогда комиссия с одного платежа составит 60 рублей, а с тысячи платежей в месяц — 60 000 рублей. Это иллюстрация расчёта, не рыночная ставка: подставьте условия вашего договора и заложите комиссию в юнит-экономику продукта.
Чек-лист перед запуском оплаты
Перед открытием оплаты реальным клиентам пройдите короткий список:
- Договор с платёжным провайдером подписан, тестовый и боевой режимы разделены.
- Сервер проверяет подпись каждого уведомления об оплате.
- Повторное уведомление не создаёт второй заказ.
- Для успешной, неуспешной и отменённой оплаты есть понятные сообщения клиенту.
- Настроено формирование чеков, если оно требуется для вашего вида деятельности.
- Есть процесс возврата и роль сотрудника, который им занимается.
- Администратор видит платежи и статусы в одном месте и может сверить их с банком.
- Настроены оповещения о сбоях платёжной интеграции.
Что делать, если платёж «завис»
Бывает, что клиент оплатил, а уведомление не пришло. Не просите его платить повторно. Заведите регулярную сверку: фоновая задача раз в несколько минут запрашивает у провайдера статус всех заказов в ожидании и обновляет их. Так вы отловите потерянные уведомления без участия поддержки, а клиент получит заказ вовремя.
Частые вопросы
Можно ли принимать оплату только через ссылку на сайт? Для физических товаров и услуг обычно да, но для цифровых товаров правила магазинов приложений могут требовать встроенных покупок. Проверьте актуальные правила до проектирования.
Нужна ли отдельная касса для онлайн-оплат? Требования к чекам зависят от вашей деятельности и формы налогообложения. Обсудите это с бухгалтером и платёжным провайдером заранее.
Как защититься от мошенничества? Подтверждайте оплату на сервере, проверяйте подписи уведомлений, ограничивайте число попыток и следите за аномалиями, например множеством отказов с одного аккаунта.
Практические рекомендации
Не стремитесь подключить все способы оплаты сразу. Выберите один основной, который удобен вашей аудитории, и один резервный на случай сбоев у провайдера. Сделайте для администратора страницу со списком платежей и фильтрами по статусу: она сэкономит часы при разборе обращений. Раз в месяц сверяйте данные системы с отчётом банка или провайдера, чтобы выявлять расхождения до того, как они накопятся.
Итог
Начните с вопроса, что вы продаёте, затем выберите способ оплаты, который допускают правила платформы, и стройте сценарий вокруг серверного подтверждения. Продуманные возвраты, чеки и обработка сбоев экономят больше денег, чем выбор самой низкой комиссии.
Если вы планируете приём оплаты в приложении или Mini App, мы поможем выбрать схему под ваше юрлицо и продукт.
Frog Studios подключает оплату в мобильных приложениях, Mini Apps и Telegram-ботах.