Взаимодействие с платёжной системой «ПСБ»

Чтобы абоненты-физлица могли оплачивать счета в личном кабинете с помощью ПСБ, последовательно настройте четыре объекта.

Личный кабинет ПСБ
Административный интерфейс АСР LANBilling
Скрипт для callback-уведомлений
Конфигурационный файл

Личный кабинет ПСБ

Отправьте заявку на эквайринг и заключите договор.

Получите от ПСБ тестовые реквизиты:

Параметр	Пример
Первая компонента ключа	C1C1C1C1C1C1C1C1C1C1C1C1C1
Вторая компонента ключа	A0A0A0A0A0A0A0A0A0A0A0A0A
TERMINAL — уникальный номер виртуального терминала	79036777
MERCH_NAME — название торгово-сервисного предприятия	TEST_MERCH
MERCHANT — номер торгово-сервисного предприятия	790367686219999

Административный интерфейс АСР LANBilling

Создайте профиль для платёжной системы в АСР LANBilling.

Скрипт для callback-уведомлений psb.py

Скрипт нужен, чтобы фиксировать в АСР LANBilling результаты оплат. Он обрабатывает запросы от платёжной системы — в них содержится информация об операциях. На основании этих данных скрипт создаёт платежи в биллинге.

Настройка различается для разных ОС.

Скопируйте файл psb.py в директорию исполняемых скриптов вашего веб-сервера:
```
cp /usr/local/billing/payments/psb/psb.py /var/www/cgi-bin/
```
``
Укажите в нём настройки доступа.
- IP-адрес и порт для подключения к LBcore.
- Логин и пароль от профиля платёжной системы в АСР LANBilling.
- Компоненты секретного ключа.
```
# Подключение к LBcore
HOST = '127.0.0.1'
PORT = 1502
MANAGER = 'Login'
PASSWORD = 'Password'
 
# Компоненты ключа
comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
```
``
Сделайте скрипт исполняемым:
```
chmod +x /var/www/cgi-bin/psb.py
```
``

Скопируйте файл psb.py в директорию исполняемых скриптов вашего веб-сервера:
```
cp /usr/local/billing/payments/psb/psb.py /usr/lib/cgi-bin/
```
``
Укажите в нём настройки доступа.
- IP-адрес и порт для подключения к LBcore.
- Логин и пароль от профиля платёжной системы в АСР LANBilling.
- Компоненты секретного ключа.
```
# Подключение к LBcore
HOST = '127.0.0.1'
PORT = 1502
MANAGER = 'Login'
PASSWORD = 'Password'
 
# Компоненты ключа
comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
```
``
Сделайте скрипт исполняемым:
```
chmod +x /usr/lib/cgi-bin/psb.py
```
``

Скопируйте файл psb.py в директорию исполняемых скриптов вашего веб-сервера:
```
cp /usr/local/billing/payments/psb/psb.py /usr/local/www/apache24/cgi-bin/
```
``
Укажите в нём настройки доступа.
- IP-адрес и порт для подключения к LBcore.
- Логин и пароль от профиля платёжной системы в АСР LANBilling.
- Компоненты секретного ключа.
```
# Подключение к LBcore
HOST = '127.0.0.1'
PORT = 1502
MANAGER = 'Login'
PASSWORD = 'Password'
 
# Компоненты ключа
comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
```
``
Сделайте скрипт исполняемым:
```
chmod +x /usr/local/www/apache24/cgi-bin/psb.py
```
``

Конфигурационный файл psb.ini

Действия различаются для разных ОС.

Внесите изменения в файл конфигурации psb.ini:
```
nano /etc/lanbilling/phpclient/client/psb.ini
```
``
- Включите платёжную систему в личном кабинете абонентов АСР LANBilling:
```
[psb]
enabled = true
```
- Укажите ссылку на платёжный шлюз ПСБ.
  - Для промышленной среды:
```
url = 'https://3ds.payment.ru/cgi-bin/cgi_link'
```
  - Или для тестового режима:
```
url = 'https://test.3ds.payment.ru/cgi-bin/cgi_link'
```
- Введите данные, полученные от ПСБ:
```
terminal = '79036777'
merch_name = 'TEST_MERCH'
merchant = '790367779999999'
```
- Укажите адрес для веб-обращений к вашему файлу psb.py:
```
notify_url = 'http://my-operator.ru/cgi-bin/psb.py'
```
- Введите значения первой и второй компонент:
```
comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
```

Сохраните конфигурационный файл. Сериализуйте изменения:
```
/usr/local/sbin/lbwebcfg -y client /etc/lanbilling/phpclient/client/
```
``

Внесите изменения в файл конфигурации psb.ini:
```
nano /usr/local/etc/lanbilling/phpclient/client/psb.ini
```
``
- Включите платёжную систему в личном кабинете абонентов АСР LANBilling:
```
[psb]
enabled = true
```
- Укажите ссылку на платёжный шлюз ПСБ.
  - Для промышленной среды:
```
url = 'https://3ds.payment.ru/cgi-bin/cgi_link'
```
  - Или для тестового режима:
```
url = 'https://test.3ds.payment.ru/cgi-bin/cgi_link'
```
- Введите данные, полученные от ПСБ:
```
terminal = '79036777'
merch_name = 'TEST_MERCH'
merchant = '790367779999999'
```
- Укажите адрес для веб-обращений к вашему файлу psb.py:
```
notify_url = 'http://my-operator.ru/cgi-bin/psb.py'
```
- Введите значения первой и второй компонент:
```
comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
```

Сохраните конфигурационный файл. Сериализуйте изменения:
```
/usr/local/sbin/lbwebcfg -y client /usr/local/etc/lanbilling/phpclient/client/
```
``

Проверка взаимодействия

Убедитесь, что в конфигурационном файле указан url для тестового режима. Проведите платежи в тестовом режиме.

После успешного тестирования платежей свяжитесь с сотрудниками ПСБ и получите реквизиты для работы в промышленной среде. Не забудьте изменить url в конфигурационном файле — теперь там должна быть указана ссылка для работы в промышленной среде.

Настройка завершена. Теперь абоненты-физлица могут пополнять баланс в личном кабинете с помощью этой платёжной системы.

Есть вопросы по документации? Пожалуйста, напишите их на itdep@lanbilling.ru.