CloudPayments
Продукт: Shelter Cloud | Уровень: Shelter | Статус: Stable
ID системы: 13
Описание
Интеграция с платёжной системой CloudPayments — российский платёжный агрегатор с поддержкой фискализации по 54-ФЗ. Особенность: виджет встраивается непосредственно в страницу, без редиректа.
Настройка в Shelter Cloud
Настройка производится в экране PrivateSettings:
- Включить интеграцию с CloudPayments
- Указать PublicId и ApiSecret
Параметры учётной записи
| Параметр | Описание |
|---|---|
| PublicId | Публичный идентификатор |
| ApiSecret | Секретный ключ API |
| Currency | Валюта: RUB, USD, EUR |
| Language | Язык интерфейса: ru, en |
Конфигурация сервиса (appsettings.json)
| Параметр | Описание |
|---|---|
| IPWhiteList | Список разрешённых IP для callback. Доступ: отдел разработки |
Дополнительные настройки
| Параметр | Описание |
|---|---|
CloudPayments_PrintCheck |
Печатать чек после оплаты |
FrontdeskPayments_PaymentSystem = 13 |
Использовать CloudPayments для оплаты |
Callback
| Параметр | Значение |
|---|---|
| URL | https://cloud.shelter.ru/Cloudpayments/Default.aspx |
| Метод | POST |
| Формат | JSON |
Мониторинг (Zabbix)
| Проверка | URL |
|---|---|
| Доступность | GET https://cloud.shelter.ru/Cloudpayments/Default.aspx |
Должен возвращаться HTTP 200 без авторизации.
Логирование
Все события логируются в Graylog (channel: CloudPayments).
Примеры сообщений при callback
Получен callback:
Оплата: POST /Cloudpayments/Default.aspx TransactionId=292637533&Amount=1800.00&Currency=RUB&Status=Completed
Успешная оплата:
Оплата успешно: 100
IP не в whitelist:
Ошибка оплаты: не допустимый ip адрес
Алгоритм подписи
CloudPayments использует проверку IP-адресов отправителя вместо подписи.
Разрешённые IP-адреса:
- 130.193.70.192/28
- 185.98.85.192/28
Процесс оплаты
Особенность: Виджет CloudPayments встраивается в страницу виджета бронирования, без редиректа на внешнюю страницу.
1. Клиент нажимает «Оплатить» в виджете бронирования
2. Открывается встроенный виджет CloudPayments (без редиректа)
3. Клиент вводит данные карты прямо в виджете
4. После успешной оплаты CloudPayments отправляет callback
5. Система проверяет IP отправителя и сохраняет платёж
Поддерживаемые валюты
| Код | Валюта |
|---|---|
| RUB | Российский рубль |
| USD | Доллар США |
| EUR | Евро |
Фискализация
CloudPayments поддерживает автоматическую фискализацию по 54-ФЗ. Настройка производится в личном кабинете CloudPayments.
Устранение неполадок
Ошибка проверки IP
Решение:
- Проверьте актуальный список IP CloudPayments в документации
- Добавьте новые диапазоны в whitelist
Виджет не загружается
Решение:
- Проверьте PublicId
- Убедитесь, что домен добавлен в разрешённые в личном кабинете
- Проверьте консоль браузера на ошибки
Callback не приходит
Решение:
- Проверьте URL в настройках личного кабинета CloudPayments
- Убедитесь, что сервер доступен из интернета
- Проверьте SSL-сертификат
Документация CloudPayments: https://developers.cloudpayments.ru/