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

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

Зачем подключать онлайн-эквайринг?

Интеграция 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 рублей).

Как это работает:

  1. После заполнения анкеты система формирует ссылку на Deposit Hold.
  2. Гость вводит данные карты — указанная сумма резервируется банком, но не списывается.
  3. После выезда администратор принимает решение:
    • Всё в порядке → «Разблокировать депозит» → средства вернутся гостю автоматически.
    • Есть ущерб → «Списать депозит» → сумма переводится на счёт отеля.

Шаг 4. Режим оплаты/доплаты за проживание

Если гость бронирует номер без предоплаты или оплачивает не полностью через PMS, система может самостоятельно запросить оставшуюся сумму.

[!IMPORTANT] Для оплаты проживания тоже используется механизм Deposit Hold. Доступны: БСПБ, Тинькофф, ЮKassa, Альфа-Банк, ВТБ.

В настройках интеграции с PMS включите параметр «Доплата за проживание» и выберите соответствующий Deposit Hold провайдер.

Как это работает:

  1. Гость бронирует номер без оплаты (или с частичной оплатой через PMS).
  2. Заполняет онлайн-анкету дистанционного заселения.
  3. Администратор верифицирует данные и нажимает «Подтвердить».
  4. В этот момент система автоматически формирует платёжную ссылку на оставшуюся сумму и отправляет её гостю.
  5. Гость оплачивает онлайн. Только после подтверждения платежа ему приходят ключи и инструкция по заселению.

Автоматическая отправка ссылки на оплату через CJM

Вы не обязаны отправлять ссылки на оплату вручную. В разделе Путь гостя (CJM) предусмотрены специальные этапы для автоматизации:

  • Этап «Оплата подтверждена» (stay_paid) — именно после этого триггера удобно отправить гостю код от замка и инструкцию по заселению, потому что вы уже убедились, что деньги поступили.
  • Этап «Анкета заполнена» (questionnaire_completed) — удобный момент, чтобы отправить ссылку на депозит, если он обязателен перед подтверждением.
  • Этап «Заселение подтверждено» (questionnaire_done) — триггер для отправки ссылки на доплату (в режиме Pay After Verify).

[!TIP] Настройте всю цепочку в CJM один раз — и система будет сама в нужный момент отправлять гостю ссылки на оплату, напоминать о незакрытом счёте и информировать об успешном поступлении средств. Администратор в этом процессе не участвует!