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