Подключение ЮKassa (Яндекс Касса)

Что нужно для подключения

• Аккаунт в ЮKassa (yookassa.ru)
• Статус ИП, ООО/АО или самозанятого (для физлиц без статуса приём платежей недоступен)
• Расчётный счёт, привязанный к ЮKassa

ЮKassa доступна на всех тарифах evntflo, включая Free.

Шаг 1. Регистрация в ЮKassa

Перейдите на yookassa.ru и создайте аккаунт. Для получения доступа к боевым платежам потребуется пройти верификацию: загрузить документы (для ИП — паспорт и свидетельство, для ООО — устав и приказ о назначении).

Тестовый режим (тестовые платежи без реальных денег) доступен сразу после регистрации без верификации.

Шаг 2. Создание магазина

В личном кабинете ЮKassa:

1. Перейдите в раздел Магазины.
2. Нажмите «Создать магазин».
3. Заполните данные: название, URL сайта (укажите app.evntflo.com), описание деятельности.
4. В разделе «Способ подключения» выберите HTTP-уведомления (не виджет).
5. Сохраните настройки.

Шаг 3. Получение API-ключей

В настройках созданного магазина:

1. Откройте вкладку «Ключи API».
2. Скопируйте shopId — это числовой идентификатор магазина (например, 123456).
3. Нажмите «Создать секретный ключ», введите подтверждение. Скопируйте secretKey вида test_XXXX... (тестовый) или live_XXXX... (боевой).

Секретный ключ показывается только один раз. Если потеряли — создайте новый, старый при этом станет недействительным.

Шаг 4. Настройка в evntflo

1. Откройте Настройки вашей организации в evntflo.
2. Перейдите в раздел Платежи → ЮKassa.
3. Введите shopId и secretKey.
4. Нажмите «Проверить подключение» — evntflo сделает тестовый запрос к API ЮKassa.

При успешной проверке появится зелёный статус «Подключено».

Шаг 5. Настройка webhook

После успешной проверки evntflo отобразит webhook URL для вашего магазина (вида https://app.evntflo.com/webhooks/yookassa/{shopId}).

В настройках магазина ЮKassa:

1. Откройте «HTTP-уведомления».
2. Добавьте webhook URL.
3. Выберите события для отправки:
   • payment.succeeded — платёж успешно выполнен
   • payment.canceled — платёж отменён
   • refund.succeeded — возврат выполнен

Шаг 6. Тестирование

Для тестирования используйте тестовый ключ (начинается с test_). Тестовые карты ЮKassa:

Срок действия — любая будущая дата, CVV — любые 3 цифры.

Шаг 7. Переход в боевой режим

Когда тестирование пройдено успешно:

1. В ЮKassa подайте заявку на подключение к боевому режиму (кнопка в дашборде магазина).
2. Загрузите необходимые документы.
3. После одобрения ЮKassa пришлёт уведомление.
4. Замените тестовый secretKey на боевой в настройках evntflo.

Одобрение обычно занимает 1–3 рабочих дня для ИП и 3–5 дней для ООО.