Подключение систем онлайн-оплаты

Зачем подключать онлайн-эквайринг?
Интеграция Concierge CRM c платёжным шлюзом позволяет:
- Получать оплату за проживание автоматически, ещё до заезда гостя, без звонков и ручной проверки.
- Блокировать страховой депозит (Deposit Hold) на банковской карте гостя при заселении — сумма резервируется, но не списывается. Если всё в порядке — депозит разблокируется после выезда одним кликом.
- Отправлять ссылку на оплату гостю автоматически через CJM (путь гостя) — в нужный момент, без участия администратора.
Поддерживаемые платёжные системы
[!IMPORTANT] Не все платёжные шлюзы поддерживают все режимы работы. Внимательно изучите таблицы ниже перед выбором провайдера.
🔒 Страховой депозит (Deposit Hold)
Для блокировки страхового залога поддерживаются только два провайдера, работающих по механизму Deposit Hold:
| Провайдер | Описание |
|---|---|
| ЮKassa (YooKassa) — Deposit Hold | Рекомендован как основной вариант |
| Тинькофф (T-Bank) — Deposit Hold | Альтернатива для клиентов Т-Банка |
Карта гостя блокируется на сумму залога, но деньги не списываются до явного подтверждения со стороны администратора. После выезда депозит либо разблокируется (возврат), либо captures (списание за ущерб).
💰 Оплата/доплата за проживание (Deposit Hold)
Для сбора оплаты или доплаты за проживание также используется механизм Deposit Hold. Поддерживаются:
| Провайдер |
|---|
| БСПБ / FirstKKM — Deposit Hold |
| Тинькофф (T-Bank) — Deposit Hold |
| ЮKassa (YooKassa) — Deposit Hold |
| Альфа-Банк — Deposit Hold |
| ВТБ (VTB) |
В этом режиме система формирует платёжную ссылку, гость оплачивает проживание онлайн, а средства поступают на счёт отеля после выезда (или сразу — в зависимости от настроек провайдера).
💳 Прочие методы оплаты
Доступны для оплаты дополнительных услуг (Room Service, витрина) и иных платежей (не за проживание и не залог):
| Провайдер |
|---|
| ЮKassa (YooKassa) |
| Тинькофф (T-Bank) |
| Сбербанк Эквайринг |
| Альфа-Банк |
| CloudPayments |
| EcommPay |
| ComfortBooking |
| Банковский счёт (Invoice) — безналичная оплата по счёту |
| Оплата произведена — ручное подтверждение без шлюза |
Шаг 1. Подключение платёжного шлюза
Перейдите в настройки: Настройки → Методы оплаты.
В списке доступных провайдеров найдите нужный (например, ЮKassa) и нажмите на иконку редактирования (карандаш).
В открывшемся окне введите реквизиты, которые вам выдаёт выбранный платёжный шлюз в своём личном кабинете:
- API Key (Публичный ключ / ID магазина) — идентификатор вашего магазина/мерчанта в системе эквайрера.
- API Secret / Token (Секретный ключ) — приватный ключ для подписи запросов. Хранится строго конфиденциально.
Нажмите Сохранить. Метод оплаты перейдёт в статус активного.
[!TIP] Если вы не знаете, где взять API-ключи, обратитесь в службу поддержки вашего банка-эквайрера. Обычно они выдаются в разделе «Интеграция» или «Настройки магазина» в личном кабинете платёжной системы.
Шаг 2. Привязка эквайринга к настройкам PMS
После активации метода оплаты необходимо указать системе, какой шлюз использовать для конкретного объекта.
Перейдите в: Настройки → Интеграции → выберите вашу PMS (например, Bnovo) → нажмите Редактировать.
В настройках интеграции вы найдёте выпадающий список «Платёжная система». Выберите в нём только что подключённый провайдер (например, «ЮKassa»).
С этого момента все платёжные ссылки, которые система генерирует для гостей этого объекта, будут проходить через выбранный шлюз.
Шаг 3. Режим страхового депозита
Если ваш объект берёт страховой залог с гостей, включите режим Deposit Hold.
[!IMPORTANT] Для депозита поддерживаются только ЮKassa (Deposit Hold) и Тинькофф (Deposit Hold). Убедитесь, что именно один из них подключён и выбран в настройках PMS.
В настройках интеграции с PMS найдите параметр «Сумма депозита» и укажите фиксированную сумму залога (например, 3000 рублей).
Как это работает:
- После заполнения анкеты система формирует ссылку на Deposit Hold.
- Гость вводит данные карты — указанная сумма резервируется банком, но не списывается.
- После выезда администратор принимает решение:
- Всё в порядке → «Разблокировать депозит» → средства вернутся гостю автоматически.
- Есть ущерб → «Списать депозит» → сумма переводится на счёт отеля.
Шаг 4. Режим оплаты/доплаты за проживание
Если гость бронирует номер без предоплаты или оплачивает не полностью через PMS, система может самостоятельно запросить оставшуюся сумму.
[!IMPORTANT] Для оплаты проживания тоже используется механизм Deposit Hold. Доступны: БСПБ, Тинькофф, ЮKassa, Альфа-Банк, ВТБ.
В настройках интеграции с PMS включите параметр «Доплата за проживание» и выберите соответствующий Deposit Hold провайдер.
Как это работает:
- Гость бронирует номер без оплаты (или с частичной оплатой через PMS).
- Заполняет онлайн-анкету дистанционного заселения.
- Администратор верифицирует данные и нажимает «Подтвердить».
- В этот момент система автоматически формирует платёжную ссылку на оставшуюся сумму и отправляет её гостю.
- Гость оплачивает онлайн. Только после подтверждения платежа ему приходят ключи и инструкция по заселению.
Автоматическая отправка ссылки на оплату через CJM
Вы не обязаны отправлять ссылки на оплату вручную. В разделе Путь гостя (CJM) предусмотрены специальные этапы для автоматизации:
- Этап «Оплата подтверждена» (
stay_paid) — именно после этого триггера удобно отправить гостю код от замка и инструкцию по заселению, потому что вы уже убедились, что деньги поступили. - Этап «Анкета заполнена» (
questionnaire_completed) — удобный момент, чтобы отправить ссылку на депозит, если он обязателен перед подтверждением. - Этап «Заселение подтверждено» (
questionnaire_done) — триггер для отправки ссылки на доплату (в режиме Pay After Verify).
[!TIP] Настройте всю цепочку в CJM один раз — и система будет сама в нужный момент отправлять гостю ссылки на оплату, напоминать о незакрытом счёте и информировать об успешном поступлении средств. Администратор в этом процессе не участвует!