💡 Зачем нужна эта интеграция
Интеграция Битрикс24 и ЮKassa превращает CRM из системы учета сделок в полноценный инструмент приема платежей. Без связки менеджер вручную выставляет счет, отправляет клиенту реквизиты или ссылку, затем проверяет поступление денег в личном кабинете ЮKassa и только после этого двигает сделку по воронке. Это занимает время, провоцирует ошибки (перепутанные суммы, пропущенные оплаты, дубли счетов) и задерживает отгрузку товара или начало оказания услуги. Когда оба сервиса работают согласованно, платеж становится частью единого бизнес-процесса: оплата создается из карточки сделки, а ее статус автоматически отражается в CRM.
Для бизнеса это дает несколько ощутимых преимуществ. Во-первых, ускоряется цикл продаж: клиент получает персональную ссылку на оплату сразу после согласования заказа, а при успешном платеже сделка автоматически переходит на стадию «Оплачено», запускаются робот или бизнес-процесс (уведомление склада, выдача доступа к курсу, создание задачи на отгрузку, отправка чека). Во-вторых, уменьшается нагрузка на менеджеров и бухгалтерию: не нужно сверять банковские выписки и уведомления ЮKassa с данными в CRM, а информация об оплатах, возвратах и отмененных платежах собирается в одном месте. В-третьих, повышается прозрачность аналитики: руководитель видит реальную выручку по менеджерам, каналам и продуктам, а не только суммы «в работе».
Важно понимать, что между Битрикс24 и ЮKassa обычно нет единой универсальной «кнопки» интеграции на все случаи жизни. Базовые способы подключения: встроенные платежные системы Битрикс24 (для интернет-магазина, CRM-форм и счетов, где ЮKassa доступна как обработчик платежей в зависимости от тарифа и региона), готовые виджеты и приложения из Маркетплейса Битрикс24, а также платформы-коннекторы вроде Make, Zapier и APIX-Drive, которые связывают сервисы через вебхуки и API. Выбор зависит от сложности ваших процессов: для простых сценариев хватит встроенных средств, для гибкой логики с произвольными статусами и уведомлениями лучше подойдет коннектор.
🛠️ Как настроить интеграцию
- **Шаг 1. Подготовьте аккаунты и доступы.** В личном кабинете ЮKassa убедитесь, что магазин подключен и прошел модерацию, и скопируйте `shopId` и секретный ключ (раздел «Интеграция» → «Ключи API»). В Битрикс24 проверьте, что у вас есть права администратора и доступны нужные инструменты (CRM, роботы и бизнес-процессы, вебхуки; часть функций зависит от тарифа). Определите сценарий: оплата по ссылке из сделки, оплата счета или оплата заказа в онлайн-магазине. Заведите в CRM воронку со стадиями, например «Ожидает оплаты», «Оплачено», «Оплата не прошла». Для тестов включите в ЮKassa тестовый магазин, чтобы не списывать реальные деньги.
- **Шаг 2. Выберите способ подключения.** Вариант А: встроенные платежные системы. В Битрикс24 откройте раздел «Продажи» (или «Магазин») → «Платежные системы» и добавьте ЮKassa, указав `shopId` и секретный ключ, а в ЮKassa пропишите URL для уведомлений (HTTP-уведомления о платежах), который предложит Битрикс24. Вариант Б: приложение или виджет ЮKassa из Маркетплейса Битрикс24, если оно подходит под ваш тариф и сценарий. Вариант В: коннектор Make, Zapier или APIX-Drive, если нужна гибкая логика, и этот вариант описан ниже.
- **Шаг 3. Настройте связку через коннектор (если нет готового решения).** В Make, Zapier или APIX-Drive создайте новый сценарий. Первым модулем (триггером) выберите Битрикс24: например, «Сделка перешла на стадию "Ожидает оплаты"». Авторизуйте аккаунт Битрикс24 через OAuth или входящий вебхук. Вторым модулем добавьте ЮKassa (через готовый модуль или универсальный HTTP-запрос к API `https://api.yookassa.ru/v3/payments`), передайте в нем сумму из сделки, валюту, описание заказа, `return_url` и ключ идемпотентности (`Idempotence-Key`). Для HTTP-запроса используйте Basic-авторизацию: `shopId` как логин, секретный ключ как пароль. Из ответа ЮKassa возьмите `confirmation_url` и третьим модулем запишите ссылку в пользовательское поле сделки, а при желании отправьте ее клиенту по e-mail, в мессенджер или открытую линию.
- **Шаг 4. Настройте обратную связь: обновление статуса оплаты.** В ЮKassa в разделе «Интеграция» → «HTTP-уведомления» включите события `payment.succeeded`, `payment.canceled` и `refund.succeeded`. В качестве адреса укажите URL вебхука из второго сценария коннектора (триггер «Custom Webhook» в Make или «Catch Hook» в Zapier). В сценарии добавьте поиск сделки по идентификатору платежа или номеру заказа, переданному в метаданных (`metadata`). Затем настройте действия: при `payment.succeeded` переводите сделку на стадию «Оплачено», записывайте сумму и дату платежа, создавайте задачу ответственному; при `payment.canceled` переводите сделку в «Оплата не прошла» и уведомляйте менеджера; при возврате фиксируйте его в комментарии или отдельном поле. Для надежности добавьте проверку статуса платежа запросом к API ЮKassa, а не только доверие входящему уведомлению.
- **Шаг 5. Протестируйте интеграцию и запустите в работу.** Создайте тестовую сделку с небольшой суммой, переведите ее на стадию «Ожидает оплаты» и убедитесь, что платеж создался в ЮKassa, а ссылка появилась в карточке сделки. Оплатите заказ тестовой картой (в тестовом магазине ЮKassa) или реальным платежом на минимальную сумму и проверьте, что: уведомление пришло в коннектор, сделка перешла на стадию «Оплачено», поля заполнены корректно, роботы сработали, дублей платежей нет. Затем проверьте негативные сценарии: отмену платежа, повторную отправку уведомления и возврат средств. Просмотрите историю выполнения сценария и логи ошибок, настройте оповещения о сбоях. После успешных тестов переключите магазин на боевые ключи, проведите первую реальную оплату под контролем и передайте менеджерам короткую инструкцию по работе с платежными ссылками.