К содержанию
База CRMДокументация
Открыть Базу

ЮKassa

Подключение и тестовый магазин

Интеграция с ЮKassa принимает онлайн-оплату прямо из CRM: менеджер выставляет счёт из карточки сделки (или это делает автоматизация), клиент получает ссылку на оплату, а статус платежа сам возвращаетс...

Интеграция с ЮKassa принимает онлайн-оплату прямо из CRM: менеджер выставляет счёт из карточки сделки (или это делает автоматизация), клиент получает ссылку на оплату, а статус платежа сам возвращается в сделку и запускает автоматизации — «оплачено», «ожидает подтверждения», «отменён», «возврат».

#Что понадобится

  • Магазин в ЮKassa (для первых проверок — тестовый магазин, его можно создать до заключения договора).
  • shopId и секретный ключ: личный кабинет ЮKassa → «Интеграция» → «Ключи API». Ключ тестового магазина начинается с test_, боевого — с live_.
  • Роль владельца или админа в CRM.
  • Коллекция, из которой выставляются счета (обычно «Сделки»), и — если в магазине включена фискализация — контакты с email или телефоном покупателя.

#Тестовый магазин — начните с него

В тестовом магазине всё работает как в боевом: создаются платежи, открывается страница оплаты, приходят уведомления, срабатывают автоматизации, делаются возвраты. Реальные деньги при этом не списываются.

Создать тестовый магазин

  1. Откройте личный кабинет ЮKassa

    В переключателе магазинов выберите «Тестовый магазин» (или «Создать тестовый магазин»).

  2. Скопируйте shopId

    Он показан в разделе «Интеграция → Ключи API» тестового магазина.

  3. Выпустите секретный ключ

    Там же нажмите «Выпустить ключ». Ключ показывается один раз — сразу вставьте его в CRM.

Как оплатить в тестовом магазине

Откройте ссылку на оплату и введите тестовую карту ЮKassa, например 5555 5555 5555 4477: срок действия — любая дата в будущем, CVC — любые три цифры. Полный список тестовых карт и сценариев (отказ банка, 3-D Secure) — в документации ЮKassa, раздел «Тестирование».

Подключить ЮKassa в CRM

  1. Откройте «Интеграции» → «Каталог» → ЮKassa

    Выберите режим: «Тестовый магазин» или «Боевой магазин».

  2. Вставьте shopId и секретный ключ

    В тестовом режиме CRM примет только ключ test_… — перепутать магазины не получится.

  3. Выберите коллекцию для счетов

    Обычно «Сделки». Там появятся колонки «Ссылка на оплату», «Статус оплаты ЮKassa», «Оплачено ЮKassa» и «ЮKassa платёж».

  4. Выберите контакты покупателей

    Необязательно, но нужно для чеков 54-ФЗ: email или телефон берётся у контакта, связанного со сделкой.

  5. Отметьте стадийность и импорт

    «Списывать деньги сразу» — обычный платёж. Снимите отметку для двухстадийных платежей. «Загружать платежи, созданные не из CRM» — если через ЮKassa платят и на сайте.

  6. Нажмите «Установить»

    CRM проверит ключи в ЮKassa, определит, тестовый ли магазин и включена ли фискализация, и создаст коллекцию «Платежи ЮKassa».

#HTTP-уведомления: статусы за секунды

В карточке подключения («Мои интеграции») и в «Настройках» показан адрес HTTP-уведомлений. Вставьте его в ЮKassa, чтобы статус оплаты приходил в CRM сразу:

Настроить уведомления

  1. Скопируйте адрес в CRM

    Кнопка копирования рядом с адресом. В адресе есть секрет — не публикуйте его.

  2. Откройте ЮKassa → «Интеграция» → «HTTP-уведомления»

    Для тестового и боевого магазина уведомления настраиваются отдельно.

  3. Вставьте адрес и отметьте события

    payment.succeeded, payment.waiting_for_capture, payment.canceled, refund.succeeded. Сохраните.

Нужен https

ЮKassa отправляет уведомления только на адрес с https. Пока CRM открыта по http, статусы всё равно обновятся — сверкой каждые 5 минут.

Уведомлениям не доверяем на слово

Уведомление ЮKassa не подписано, поэтому CRM проверяет секрет в адресе и затем перезапрашивает платёж у ЮKassa по своим ключам. Поддельный запрос не может «оплатить» сделку.

#Переход на боевой магазин

Когда всё проверено: «Мои интеграции» → ЮKassa → «Настройки» → режим «Боевой магазин», укажите shopId и секретный ключ боевого магазина и сохраните. CRM сразу проверит ключи. Не забудьте настроить HTTP-уведомления и в боевом магазине. Платежи тестового магазина остаются в коллекции с отметкой «Тестовый платёж».

#Отключение

«Отключить» останавливает выставление счетов и сверку. Коллекция «Платежи ЮKassa» и данные в сделках остаются. Адрес уведомлений в ЮKassa удалите вручную.