После настройки гости смогут оплачивать бронирования через ваш магазин ЮKassa. Деньги поступают напрямую в подключённый магазин.
Перед началом
Подготовьте shopId и секретный ключ магазина ЮKassa. Уточните у бухгалтера, где формируются чеки и какие фискальные признаки нужно передавать для проживания и возвратного залога.
Важно. Интеграция принимает платежи гостей. Она не меняет провайдера, через которого оплачивается тариф BookingSaaS.
Добавьте подключение
- Откройте Интеграции и выберите вкладку Платежи.
- Нажмите Добавить платёжную интеграцию.
- Укажите понятное название подключения.
- Проверьте, что выбран провайдер ЮKassa.
- Создайте подключение.
Новое подключение появится в таблице. Несколько платёжных подключений можно хранить одновременно, но только одно из них используется для создания новых платежей.
Проверьте реквизиты
- В строке подключения нажмите Настроить.
- Введите shopId.
- Введите Секретный ключ.
- Выберите способ формирования чеков.
- Нажмите Проверить и сохранить.
BookingSaaS проверяет реквизиты запросом к ЮKassa. После успешной проверки ключ хранится зашифрованным, а в таблице показываются только признак сохранённых реквизитов и маска магазина.
При повторной настройке оставьте shopId и Секретный ключ пустыми, если менять их не нужно: сервис сохранит действующие реквизиты.
Настройте чеки
В поле Формирование чеков доступны два режима.
Чеки формируются вне ЮKassa
Выберите этот режим, если фискализация выполняется вашей внешней кассой. Дополнительные фискальные поля в форме не заполняются.
Чеки формирует ЮKassa
Укажите Код системы налогообложения, если он нужен магазину. Допустимы коды от 1 до 6.
Отдельно настройте позиции Позиция проживания и Позиция возвратного залога:
- НДС — без НДС, 0%, 5%, 7%, 10%, 20%, 22% и поддерживаемые расчётные ставки;
- Предмет расчёта — услуга, платёж, залог или иное;
- Способ расчёта — полная предоплата или полный расчёт.
Все три поля обязательны для каждой позиции. Значения проживания и залога могут отличаться.
Предупреждение. Не выбирайте налоговые и фискальные признаки по примеру из документации. Их должен подтвердить бухгалтер с учётом вашей кассы и схемы работы.
Настройте webhook в ЮKassa
В таблице подключений найдите Webhook URL и нажмите кнопку копирования. Добавьте этот адрес в настройках уведомлений магазина ЮKassa.
Webhook сообщает BookingSaaS об изменении платежа. Полученные сведения дополнительно сверяются с ЮKassa; тело входящего уведомления само по себе не считается подтверждением оплаты.
Если webhook не дошёл, сервис периодически перепроверяет незавершённые операции. Менеджер также может вручную запросить актуальное состояние кнопкой Обновить статус из банка.
Активируйте подключение
Подключение можно выбрать для новых платежей только после успешной проверки реквизитов. Нажмите действие активации в его строке. При активации другая платёжная касса аккаунта перестаёт использоваться для новых операций.
Отключение интеграции запрещает новые платежи, но не удаляет финансовую историю и не мешает сверять уже созданные операции.
Как проверить результат
В таблице должны отображаться:
- маска магазина;
- состояние Сохранены в колонке реквизитов;
- выбранный режим чеков;
- состояние Активна в колонке Для новых платежей;
- полный webhook URL.
После этого разрешите нужные варианты оплаты у ресурса.