💡 Зачем нужна эта интеграция
Интеграция amoCRM и ЮKassa превращает CRM из системы учета сделок в полноценный инструмент продаж с приемом оплаты. Менеджеру больше не нужно вручную выставлять счета, отправлять реквизиты и проверять поступления в личном кабинете платежной системы. Как только сделка доходит до нужного этапа воронки, система сама формирует платежную ссылку ЮKassa и передает ее клиенту через почту, мессенджер или Salesbot. После оплаты статус сделки обновляется без участия сотрудника.
Прямой «нажми и подключи» интеграции между сервисами в базовой конфигурации нет, поэтому связку настраивают одним из трех способов. Первый вариант: платформы-коннекторы Make, Zapier или APIX-Drive, которые связывают amoCRM с API и webhook-уведомлениями ЮKassa. Если у сервиса нет готового модуля ЮKassa, используют универсальные HTTP-запросы и Webhooks. Второй вариант: готовые виджеты и интеграции из маркетплейса amoMarket, которые добавляют в карточку сделки выставление счетов и онлайн-оплату. Третий вариант: собственная доработка через REST API обеих систем, если нужна нестандартная логика. Выбор зависит от объема платежей, бюджета и требований к гибкости.
Автоматизация решает типичные проблемы бизнеса:
- **Потерянные платежи.** Оплата не остается незамеченной, потому что каждое уведомление ЮKassa фиксируется в CRM.
- **Ручные ошибки.** Исключаются неверные суммы, перепутанные клиенты и дубли счетов.
- **Скорость оплаты.** Клиент получает ссылку сразу после согласования условий, а значит, чаще платит «горячим».
- **Прозрачность аналитики.** Руководитель видит в amoCRM, какие сделки оплачены, где платеж отменен, а где оформлен возврат.
- **Загрузка отдела продаж.** Менеджеры тратят время на переговоры, а не на сверку выписок.
- **Повторные касания.** При неоплате по истечении времени можно автоматически отправить напоминание или создать задачу.
🛠️ Как настроить интеграцию
- **Подготовьте обе системы и определите схему интеграции.** В личном кабинете ЮKassa завершите подключение магазина и получите **shopId** и **секретный ключ** (раздел «Интеграция» → «Ключи API»). Для тестов используйте тестовый магазин ЮKassa, чтобы не проводить реальные платежи. В amoCRM убедитесь, что у вас есть права администратора, и продумайте воронку. Например: «Новая заявка» → «Согласование» → «Ожидает оплаты» → «Оплачено» → «Отказ/возврат». Создайте в карточке сделки дополнительные поля: «Ссылка на оплату», «ID платежа ЮKassa», «Статус оплаты» и «Сумма оплаты». После этого выберите способ подключения: виджет из amoMarket, если подходит готовое решение, либо коннектор Make, Zapier или APIX-Drive для более гибкой логики.
- **Подключите коннектор или виджет к обеим системам.** Если вы используете платформу-коннектор, создайте аккаунт и добавьте подключение к amoCRM: укажите поддомен аккаунта и авторизуйтесь через OAuth, подтвердив доступ. Для ЮKassa, если готового модуля нет, используйте HTTP-модуль (в Make и Zapier это «HTTP» или «Webhooks») с Basic-авторизацией: логин — shopId, пароль — секретный ключ. Если вы выбрали виджет из amoMarket, установите его в разделе «Интеграции», откройте настройки и введите shopId и секретный ключ ЮKassa. Затем проверьте, что соединения отображаются как активные и тестовый запрос проходит без ошибок авторизации.
- **Настройте сценарий создания платежа при смене этапа сделки.** В качестве триггера укажите событие amoCRM «Сделка перемещена на этап „Ожидает оплаты“» (через Digital Pipeline, вебхук или триггер коннектора). Следующим шагом добавьте запрос на создание платежа в ЮKassa: `POST https://api.yookassa.ru/v3/payments`. Укажите сумму и валюту (RUB) из бюджета сделки, описание заказа и тип подтверждения `redirect` с адресом возврата на ваш сайт. Обязательно передайте заголовок `Idempotence-Key` с уникальным значением, например с ID сделки и меткой времени, чтобы избежать дублей. В поле `metadata` запишите ID сделки amoCRM: по нему вы определите, какую сделку обновлять после оплаты. Если нужна фискализация по 54-ФЗ, добавьте в запрос данные чека: email или телефон клиента, наименование позиции, НДС. Из ответа ЮKassa возьмите `confirmation_url` и `id` платежа и запишите их в поля сделки, затем отправьте ссылку клиенту через Salesbot, email или мессенджер.
- **Настройте обратную связь: уведомления об оплате, отмене и возврате.** В личном кабинете ЮKassa откройте «Интеграция» → «HTTP-уведомления» и укажите URL вебхука из вашего коннектора (например, из модуля Custom Webhook в Make или Catch Hook в Zapier). Включите события `payment.succeeded`, `payment.canceled` и, при необходимости, `refund.succeeded`. Во втором сценарии получите уведомление, прочитайте из него `metadata` с ID сделки и для надежности запросите статус платежа через `GET /v3/payments/{id}`. Затем настройте обновления в amoCRM:
- при `payment.succeeded` переместите сделку на этап «Оплачено», запишите статус и сумму оплаты, добавьте примечание и создайте задачу менеджеру на передачу заказа в работу;
- при `payment.canceled` переведите сделку на этап «Оплата не прошла» и создайте задачу на связь с клиентом;
- при `refund.succeeded` отметьте возврат в сделке и уведомите ответственного.
- **Протестируйте сценарий целиком и запустите его в работу.** Сначала создайте в amoCRM тестовую