Платёжные провайдеры

Раздел «Платёжные провайдеры» — здесь подключается эквайринг, через который гости оплачивают бронирования картой онлайн. Учётные данные провайдера задаются один раз для всей организации, а конкретные способы оплаты включаются уже в настройках каждого объекта.

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

Провайдер — это платёжный сервис, который принимает оплату с карт. Сейчас с готовой интеграцией работает Freedom Pay (Казахстан, тенге, карты Visa/Mastercard и кошельки Apple Pay/Google Pay).
Учётные данные провайдера хранятся на уровне организации в зашифрованном виде и используются всеми её объектами.
В организации можно держать несколько активных конфигураций одновременно — например, Freedom Pay для карт и отдельные конфигурации для разных юридических лиц.
Какие способы оплаты увидит гость на конкретном объекте — настраивается отдельно, в разделе «Способы оплаты» в настройках проекта.

Кто может управлять провайдерами

Доступ к учётным данным провайдеров — чувствительная операция, поэтому он ограничен:

SUPER_ADMIN (команда StayBase) — всегда может подключать и менять провайдеров.
Администратор организации — может управлять провайдерами, только если для организации включён режим самостоятельной настройки (self-service). По умолчанию он выключен.

Если режим выключен, страница работает в режиме просмотра: настройку ведёт команда StayBase. На странице будет плашка «Провайдеры настраиваются StayBase» с кнопкой обращения в поддержку.

Способы оплаты без эквайринга

Не каждому клиенту нужен онлайн-эквайринг. Ручные способы оплаты — наличные при заселении, Kaspi (P2P-перевод) на личный счёт оператора, банковский перевод, оплата картой через терминал — не требуют подключения провайдера на этой странице. Их не нужно заводить здесь: они включаются прямо в разделе «Способы оплаты» проекта, а оператор подтверждает поступление вручную в админке.

Режимы: TEST и LIVE

У каждого провайдера есть режим работы:

Режим	Назначение
TEST	Тестовый (sandbox). Реальные деньги не списываются. Используется для проверки, что оплата проходит корректно
LIVE	Боевой. Принимает реальные платежи от гостей

Подключение провайдера

Нажмите «Добавить провайдера» и заполните форму:

Тип провайдера — Freedom Pay. После сохранения тип поменять нельзя.
Режим — TEST или LIVE.
Юридический профиль — обязателен для LIVE, для TEST необязателен.
Название — необязательная подпись, удобна когда у организации несколько конфигураций одного провайдера (например, «Lake House — основной счёт» и «Tau Zhetysu — резерв»).
Активна — переключатель, включает приём оплаты через эту конфигурацию.

Учётные данные Freedom Pay

В блоке учётных данных укажите параметры из личного кабинета Freedom Pay:

Merchant ID (pg_merchant_id) — обязательно.
Секретный ключ — обязательно, используется для подписи запросов.
Ключ для выплат (payout secret key) — необязательно, если Freedom Pay выдал отдельный ключ для возвратов/выплат.
API URL — необязательно, переопределяет адрес API (по умолчанию api.freedompay.kz).
Время жизни ссылки на оплату — необязательно, в секундах (от 60 до 86400).

После сохранения система покажет адрес для уведомлений о платежах (webhook / Result URL) — его нужно вписать в кабинете Freedom Pay, чтобы статусы оплат обновлялись автоматически.

Настройка webhook и его статус

В карточке провайдера есть блок настройки уведомлений о платежах:

Адрес уведомлений (Result URL) — копируется кнопкой и вставляется в кабинете Freedom Pay (Настройки → Result URL). Именно по этому адресу провайдер сообщает об успешных оплатах.
Пошаговая инструкция — раскрывающийся блок «Как настроить»: открыть кабинет провайдера, прописать Result URL, провести тестовый платёж.
Индикатор состояния показывает, приходят ли уведомления:
- серый — уведомлений ещё не было (адрес не настроен в кабинете);
- зелёный — последнее уведомление получено недавно, всё работает;
- жёлтый — уведомлений не было дольше 7 дней (возможно, нет платежей или адрес изменился).

Тестовый платёж

Чтобы убедиться, что подключение настроено правильно, нажмите «Отправить тест» в карточке провайдера. Система создаст тестовый платёж в sandbox-режиме (тестовая карта), вернёт ссылку на оплату — реальные деньги не списываются даже на боевой (LIVE) конфигурации. Такой платёж не попадает в историю и не учитывается в лимитах.

Рядом отображается результат последней проверки: дата, успех или ошибка с текстом. После успешной оплаты тестовой картой провайдер пришлёт уведомление, индикатор webhook станет зелёным — это подтверждает, что весь путь оплаты работает от начала до конца.

Управление провайдером

Изменить — поменять режим, юридический профиль, название или активность. Чтобы заменить учётные данные, включите переключатель «Обновить ключи» — поля для ввода появятся снова (текущие ключи показываются в замаскированном виде и не отдаются обратно из соображений безопасности).
Выключить — снимите переключатель «Активна», чтобы временно остановить приём оплаты через эту конфигурацию, не удаляя её.
Удалить — убрать конфигурацию полностью.