Khaiam labs

Разработка / платежи / ЮKassa

Интеграция ЮKassa с сайтом и Telegram-ботом

Подключаем приём оплаты через API ЮKassa там, где нет готового модуля: сайты и сервисы на собственной разработке, Telegram-боты, Mini App. Платёж, статус заказа, чек, возврат и подписка работают как одна цепочка, а не как кнопка «Оплатить» сама по себе.

Обсудить интеграцию Написать в Telegram

Подключение к сайту или боту — от 25 000 ₽

API ЮKassa / webhooks / чеки 54-ФЗ / возвраты / автоплатежи / Telegram / Mini App / CRM / 1С

Когда нужна интеграция

Готовый модуль подходит не всем.

Если сайт на популярном конструкторе или CMS, ЮKassa подключается готовым модулем в настройках — разработчик не нужен. Интеграция через API нужна, когда логики больше, чем одна кнопка.

Сайт или сервис написан на заказ

Модуля под вашу систему нет: нужно создать платёж из своего кода, принять уведомление от ЮKassa и правильно обновить заказ, личный кабинет или доступ.

Продаёте в Telegram-боте или Mini App

Бот выставляет счёт, клиент платит по ссылке, а после подтверждения оплаты бот сам выдаёт товар, доступ или запись — без менеджера.

Нужна подписка с автосписанием

Клиент платит один раз и сохраняет способ оплаты, дальше списания идут по расписанию, а доступ продлевается или закрывается по статусу платежа.

Оплаты должны попадать в CRM или 1С

Менеджер видит оплаченную сделку, бухгалтерия — платёж и чек, а никто не сверяет выписку руками в конце дня.

Что входит

Подключаем всю цепочку оплаты.

Большинство проблем с оплатой возникает не в момент платежа, а после: потерянное уведомление, повторное событие, чек без позиций, заказ в неправильном статусе. Это закладываем сразу.

Платёж

Создание и подтверждение

Создаём платёж из вашего кода, отправляем клиента на страницу оплаты ЮKassa или встраиваем виджет. Ключ идемпотентности защищает от двойных списаний при повторных запросах.

  • Карты, СБП, ЮMoney и другие способы из вашего договора.
  • Одностадийная оплата или холдирование с подтверждением.

Статусы

Webhooks и заказы

Принимаем уведомления ЮKassa об успешной оплате, отмене и возврате, сверяем статус платежа через API и только потом меняем заказ. Повторное уведомление не создаёт второй заказ.

  • Уведомление менеджеру и клиенту.
  • Журнал платёжных событий для разбора спорных случаев.

Чеки и возвраты

54-ФЗ и деньги назад

Передаём состав заказа для чека через «Чеки от ЮKassa» или вашу онлайн-кассу. Возвраты — полные и частичные, из админки или автоматически по правилам.

  • Чек связан с конкретным платежом.
  • Ставки НДС и СНО подтверждает ваш бухгалтер.

Подписки

Рекуррентные платежи и доступ по подписке.

Подписка — это не только регулярное списание. Нужно решить, что происходит с доступом, когда списание не прошло, как клиент отключает подписку и как это видно в вашей админке.

Сохранение способа оплаты

При первой оплате клиент соглашается сохранить карту, кошелёк ЮMoney или счёт СБП. Мы храним только идентификатор способа оплаты из ЮKassa — данные карты к вам не попадают.

Списания по расписанию

Продление в нужный день, повторная попытка, если на карте не было денег, уведомление клиенту до списания и после него.

Доступ следует за оплатой

Успешное списание продлевает доступ в боте, приложении или личном кабинете. Неуспешное — даёт льготный период и закрывает доступ по вашим правилам.

Отключение в один шаг

Клиент отключает подписку сам — кнопкой в боте или кабинете. Это требование ЮKassa и меньше споров и возвратов.

В боевом магазине автоплатежи включает менеджер ЮKassa по вашему запросу. Оферту с условиями подписки готовит ваш юрист, технические требования к ней подскажем.

Процесс

Сначала тестовый магазин, потом боевые платежи.

У ЮKassa есть тестовый магазин: все сценарии — успешная оплата, отказ, возврат, автоплатёж — проходим на нём до того, как через интеграцию пойдут настоящие деньги.

  1. 01

    Разбираем сценарий

    Что продаёте, где клиент платит, что должно произойти после оплаты, нужны ли подписки, чеки, возвраты, CRM или 1С.

  2. 02

    Делаем на тестовом магазине

    Платёж, webhooks, статусы, чеки и автоплатежи — на тестовых данных, без риска для реальных клиентов.

  3. 03

    Переключаем на боевой

    Меняем ключи на боевые, проводим контрольную оплату и возврат, проверяем чек и уведомления.

  4. 04

    Сдаём и остаёмся на связи

    Описание сценариев и событий, доступы у вас, мониторинг ошибок. Поддержку после запуска можно оставить у нас.

Стоимость

Сколько стоит интеграция ЮKassa.

Цена зависит от сценариев, а не от числа строк кода. Точную смету называем после разбора задачи и доступа к проекту.

Оплата на сайте или в боте

от 25 000 ₽

Разовые платежи для сайта, сервиса, Telegram-бота или Mini App: создание платежа, webhooks, статусы, чеки и возвраты.

  • Тестовый и боевой магазин.
  • Уведомления о новых оплатах.

Подписки и автоплатежи

от 50 000 ₽

Рекуррентные списания, продление и закрытие доступа, повторные попытки, отключение подписки клиентом, история платежей.

  • Логика доступа в боте, приложении или кабинете.
  • Подсказки по требованиям ЮKassa к оферте.

Связка с CRM или 1С

от 40 000 ₽

Оплаты, статусы и возвраты попадают в amoCRM, Битрикс24 или 1С. Для 1С объём зависит от конфигурации — оцениваем после разбора.

  • Карта событий: платёж → сделка → документ.
  • Без двойного ввода и ручной сверки.

До старта

Что нужно с вашей стороны.

Договор с ЮKassa и магазин — ваши. Мы подключаем к ним ваш продукт и не принимаем деньги клиентов на свои счета.

Магазин в ЮKassa

Заявку на подключение подаёте вы. Перед подключением ЮKassa проверяет сайт или бота: описание товаров, цены, оферту и контакты. Если чего-то не хватает, подскажем, что добавить.

Доступы

Идентификатор магазина и секретный ключ, доступ к коду и серверу или к боту. Ключи храним только на сервере, не в коде и не в переписке.

Данные для чеков

Система налогообложения, ставки НДС, признак предмета расчёта — это подтверждает бухгалтер. Мы отвечаем за то, чтобы эти данные правильно уходили в чек.

Чего не делаем

Не настраиваем готовые модули ЮKassa в конструкторах сайтов — это делается в их настройках. Не работаем с чужими кабинетами без подтверждённого доступа владельца.

FAQ

Что спрашивают перед интеграцией ЮKassa.

Сколько стоит интеграция ЮKassa?

Подключение оплаты к сайту, сервису или Telegram-боту — от 25 000 ₽. Подписки с автоплатежами — от 50 000 ₽. Передача оплат и статусов в 1С или CRM — от 40 000 ₽. Точную смету называем после разбора сценария.

Можно ли принимать рекуррентные платежи через ЮKassa?

Да. Клиент сохраняет карту, кошелёк ЮMoney или счёт СБП при первой оплате, дальше списания идут по расписанию. В боевом магазине автоплатежи включает менеджер ЮKassa по вашему запросу. От вас нужны оферта с условиями подписки, согласие клиента и способ отключить подписку — эту логику мы делаем в продукте.

Если у сайта есть готовый модуль ЮKassa, вы нужны?

Обычно нет. Для популярных конструкторов и CMS у ЮKassa есть готовые модули, их подключают в настройках. Мы нужны, когда сайт написан на заказ, оплата идёт в боте или Mini App, нужны подписки или оплаты должны попадать в CRM и 1С.

Нужна ли онлайн-касса и чеки по 54-ФЗ?

Чек при оплате онлайн обычно нужен. Его можно отправлять через «Чеки от ЮKassa» или через вашу онлайн-кассу, подключённую к ЮKassa. Мы передаём состав заказа и связываем чек с платежом, а систему налогообложения и ставки НДС подтверждает бухгалтер.

Можно ли подключить ЮKassa к Telegram-боту?

Да. Бот создаёт платёж, клиент оплачивает по ссылке, после подтверждения от ЮKassa бот выдаёт доступ, товар или запись. Так же работают подписки: доступ продлевается при успешном списании и закрывается, если оплата не прошла. Подробнее о ботах — на странице разработки Telegram-ботов.

Оплата уже подключена, но работает с ошибками. Поможете?

Да, это отдельная услуга — диагностика и починка оплаты: деньги списались, а заказа нет, не уходят чеки, CRM видит не тот статус. Диагностика одного сценария — от 7 500 ₽.

Заявка

Расскажите, где и что вы продаёте.

Можно коротко: сайт или бот, разовые платежи или подписка, нужны ли чеки, CRM или 1С. Вернёмся с вопросами и оценкой.

Интеграция ЮKassa

Короткая заявка на интеграцию.

Если магазина в ЮKassa ещё нет, это не проблема — подскажем, что подготовить к подключению.

Написать в Telegram

Заявка придёт на hi@khaiam.ru. NDA можно согласовать до передачи доступа к коду и платёжному кабинету.