💡 Зачем нужна эта интеграция
Связка ЮKassa и Битрикс24 нужна компаниям, которые принимают онлайн-оплату и ведут клиентов, сделки и счета в CRM. Без интеграции менеджеры вручную сверяют платежи в личном кабинете ЮKassa с карточками сделок в Битрикс24, а на это уходят часы. Ошибки при этом неизбежны: оплаченный заказ долго висит в статусе «Ожидает оплаты», клиент не получает подтверждение, а бухгалтерия узнаёт о поступлении денег с опозданием. Автоматическая передача данных о платежах напрямую в CRM убирает эти проблемы и даёт руководителю актуальную картину продаж.
Интеграция работает так. Когда клиент оплачивает счёт или заказ, ЮKassa отправляет уведомление (webhook) о смене статуса платежа. Битрикс24 принимает его и автоматически меняет стадию сделки на «Оплачено», создаёт задачу для менеджера или отдела логистики, фиксирует оплату в истории клиента и запускает следующие шаги бизнес-процесса. Среди них отправка чека и письма с доступом к продукту, уведомление в чат или Telegram, начисление бонусов, передача заказа на склад. В обратную сторону сделка или счёт из Битрикс24 может сформировать ссылку на оплату в ЮKassa и отправить её клиенту по e-mail, в мессенджере или в открытой линии.
Важно учитывать, что у ЮKassa и Битрикс24 нет универсальной «кнопочной» интеграции, которая подходит для любого бизнеса. Настройка выполняется одним из трёх способов: через готовые модули и виджеты из Маркетплейса Битрикс24 (в том числе платёжные решения для «1С-Битрикс: Управление сайтом» и CRM-форм), через платформы-коннекторы (Make, Zapier, APIX-Drive, Albato, n8n), либо через webhook и REST API, если нужна нестандартная логика. Коннекторы подходят малому и среднему бизнесу: они не требуют программиста, настраиваются за один-два часа и позволяют гибко менять сценарии по мере роста компании.
🛠️ Как настроить интеграцию
- **Шаг 1. Подготовьте аккаунты и определите способ интеграции.** Убедитесь, что у вас есть подтверждённый магазин в ЮKassa (доступ к «Настройкам» и разделу «Интеграция – HTTP-уведомления») и аккаунт Битрикс24 с правами администратора. Выберите способ подключения. Если оплата идёт через сайт на «1С-Битрикс», используйте штатный платёжный модуль ЮKassa. Если нужны сделки и счета CRM, откройте Маркетплейс Битрикс24 и поищите виджет или приложение для ЮKassa. Для остальных случаев выберите коннектор (Make, Zapier, APIX-Drive) и зарегистрируйтесь в нём. Заранее решите, какие события нужно автоматизировать: успешная оплата, отмена, возврат, создание ссылки на оплату.
- **Шаг 2. Получите ключи доступа в ЮKassa.** В личном кабинете ЮKassa скопируйте shopId и создайте секретный ключ в разделе «Интеграция – Ключи API». Сохраните его в надёжном месте, повторно он не показывается. Затем включите HTTP-уведомления: укажите URL, на который ЮKassa будет отправлять события (адрес webhook из коннектора или из Битрикс24), и отметьте события payment.succeeded, payment.canceled и refund.succeeded. Для тестов используйте тестовый магазин ЮKassa с отдельными ключами, чтобы не проводить реальные платежи.
- **Шаг 3. Подключите Битрикс24 к платформе-коннектору.** В Make, Zapier или APIX-Drive создайте новый сценарий. В качестве источника (триггера) выберите ЮKassa или модуль Webhooks и вставьте shopId и секретный ключ. В качестве приёмника выберите Битрикс24 и авторизуйтесь через адрес портала вида `вашакомпания.bitrix24.ru`, разрешив доступ к CRM. Если готового коннектора нет, создайте во «Входящем вебхуке» Битрикс24 (Разработчикам – Другое – Входящий вебхук) ключ с правами на CRM и используйте его в запросах REST API, например `crm.deal.update` или `crm.invoice.update`.
- **Шаг 4. Настройте логику сопоставления и действия.** Передавайте в metadata платежа ЮKassa идентификатор сделки или счёта Битрикс24 (например, `deal_id`), чтобы система знала, какую карточку обновлять. Затем задайте правила:
- при событии `payment.succeeded` переводить сделку на стадию «Оплачено» и записывать сумму и номер платежа в пользовательские поля;
- при `payment.canceled` ставить задачу менеджеру связаться с клиентом;
- при `refund.succeeded` менять стадию на «Возврат» и уведомлять бухгалтера;
- при необходимости создавать ссылку на оплату по кнопке в сделке (через робота или бизнес-процесс) и отправлять её клиенту.
Дополнительно добавьте автоматические уведомления в чат, e-mail или Telegram.
- **Шаг 5. Протестируйте интеграцию и запустите её в работу.** Создайте тестовую сделку в Битрикс24 и сформируйте платёж в тестовом магазине ЮKassa, используя тестовую банковскую карту из документации. Проверьте по порядку:
- webhook дошёл до коннектора (смотрите историю запусков сценария);
- стадия сделки сменилась, а сумма и ID платежа записались в нужные поля;
- создались задача и уведомление для ответственного;
- отмена и возврат обрабатываются корректно.
Если что-то не сработало, проверьте права вебхука, правильность `deal_id` в metadata и журнал ошибок коннектора. Когда все сценарии проходят успешно, замените тестовые shopId и секретный ключ на боевые, включите сценарий в рабочем режиме и проведите первый реальный платёж на небольшую сумму. В первые дни контролируйте журнал запусков, чтобы вовремя заметить сбои.