PMS №1 / Документация
В панель

Способы предоплаты

К оглавлению

Назначение

Способы предоплаты по объекту — подключение платёжных систем для приёма оплаты за бронирования. Гости могут оплатить бронь онлайн по ссылке из ваучера или из письма. Каждый объект настраивается отдельно: вы включаете нужные способы и вводите свои ключи API (ключи хранятся по объекту и не подставляются из общих настроек).

Доступные платёжные системы

  • ЮKassa — оплата картой и СБП через ЮKassa (yookassa.ru). Нужны Shop ID и Секретный ключ из личного кабинета ЮKassa.
  • ВТБ — интернет-эквайринг ВТБ. Настройка по инструкции банка.
  • СБЕР — эквайринг Сбербанка. Настройка по инструкции банка.
  • Т-Банк (Tinkoff) — эквайринг Т-Банка. Нужны Terminal Key и Secret Key.
  • CryptoCloud — оплата криптовалютой (BTC, USDT, ETH и др.) через сервис CryptoCloud. Нужен API-токен из личного кабинета CryptoCloud.
  • Альфа-Банк — интернет-эквайринг Альфа-Банка. Настройка по документации банка.
  • CloudPayments — оплата картой, СБП и др. через CloudPayments. Нужны Public ID и API Secret из личного кабинета.
  • Alipay — оплата через Alipay (интеграция в разработке; настройки можно сохранить заранее).

Основные действия

  • Включить способ оплаты — отметьте галочкой нужный шлюз и заполните поля (ключи API). Сохраните форму. После сохранения отобразится статус «Настроен» только если ключи заполнены. Пустые поля не перезаписывают уже сохранённые ключи.
  • Webhook (уведомления) — в блоке «Подключение и webhook» показаны адреса для указания в личном кабинете банка/сервиса. Они формируются автоматически по текущему домену панели. ЮKassa: …/?route=billing/webhook; Т-Банк: …/?route=billing/webhook/tinkoff; CryptoCloud: …/?route=billing/webhook/cryptocloud; CloudPayments: …/?route=billing/webhook/cloudpayments. Укажите соответствующий URL в настройках приёма платежей у банка/сервиса.

Как гость оплачивает

При создании бронирования с суммой к оплате и включённых способах предоплаты по объекту гость получает ссылку на страницу ваучера. На странице ваучера отображаются доступные способы оплаты (если настроено несколько — выбор; если один — подставляется автоматически). Гость вводит сумму (или оплачивает предложенную), нажимает «Оплатить» и переходит на страницу банка/шлюза. После успешной оплаты статус платежа обновляется в бронировании.

Предоплата по объекту

В основной информации об объекте можно задать процент предоплаты от суммы бронирования (например 50%). На странице ваучера по умолчанию предлагается к оплате остаток или указанный процент. Сумму при необходимости можно изменить вручную (частичная оплата или полная).

Важные нюансы

  • Ключи вводятся и хранятся по каждому объекту отдельно. Не оставляйте ключи в общих переменных окружения для безопасности.
  • Если отображается «Настроен» при пустых полях — значит ранее были сохранены ключи; при необходимости очистите и сохраните заново.
  • Документация по настройке webhook и ключей: ЮKassa, ВТБ, СБЕР, Т-Банк, CryptoCloud, Альфа-Банк, CloudPayments, Alipay — см. ссылки в разделе «Способы предоплаты» в панели.