Приём платежей с помощью Ckassa

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

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

Личный кабинет Ckassa

Зарегистрируйтесь в Ckassa.
Для интеграции вам понадобится идентификатор оператора — вашей компании. Его можно узнать, например, с помощью URL на странице оплаты.

Пример.

Ссылка на страницу оплаты: https://payframe.ckassa.ru/?service=123-45678-9

Идентификатор оператора — это последние символы в ссылке, «123-45678-9»

Можно проверить, найдёт ли Ckassa оператора. Для этого подставьте идентификатор в ссылку: https://ckassa.ru/payment/#!search_provider/pt_search/123-45678-9

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

Создайте профиль для платёжной системы в LANBilling. Логин и пароль нужно будет указать в скрипте callback-уведомлений.

Скрипт для callback-уведомлений osmp-ckassa.cgi

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

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

Убедитесь, что установлен PHP 7, а также пакеты perl-cgi и perl-soap-lite.
Скопируйте файл osmp-ckassa.cgi в директорию исполняемых скриптов вашего веб-сервера:
```
cp /usr/local/billing/payments/ckassa/osmp-ckassa.cgi /var/www/cgi-bin/
```
``
Укажите в файле настройки доступа.
- Метод подключения к LBcore. По умолчанию — http; если настроена работа API по SSL — https.
- IP-адрес для подключения к LBcore.
- Логин и пароль от профиля платёжной системы в LANBilling.
```
my $proto = 'http';
my $lbcore_host = '127.0.0.1';
my $manager_login = 'super_pay';
my $manager_pass = '12345';
```
``
Сделайте скрипт исполняемым:
```
chmod +x /var/www/cgi-bin/osmp-ckassa.cgi
```
``

Убедитесь, что установлен PHP 7, а также пакеты libsoap-lite-perl, libxml-simple-perl, libcgi-session-perl, libtext-iconv-perl.
Скопируйте файл osmp-ckassa.cgi в директорию исполняемых скриптов вашего веб-сервера:
```
cp /usr/local/billing/payments/ckassa/osmp-ckassa.cgi /usr/lib/cgi-bin/
```
``
Укажите в файле настройки доступа.
- Метод подключения к LBcore. По умолчанию — http; если настроена работа API по SSL — https.
- IP-адрес для подключения к LBcore.
- Логин и пароль от профиля платёжной системы в LANBilling.
```
my $proto = 'http';
my $lbcore_host = '127.0.0.1';
my $manager_login = 'super_pay';
my $manager_pass = '12345';
```
``
Сделайте скрипт исполняемым:
```
chmod +x /usr/lib/cgi-bin/osmp-ckassa.cgi
```
``

Убедитесь, что установлен PHP 7, а также пакеты p5-IO-SessionData и p5-SOAP-Lite.
Скопируйте файл osmp-ckassa.cgi в директорию исполняемых скриптов вашего веб-сервера:
```
cp /usr/local/billing/payments/ckassa/osmp-ckassa.cgi /usr/local/www/apache24/cgi-bin/
```
``
Укажите в файле настройки доступа.
- Метод подключения к LBcore. По умолчанию — http; если настроена работа API по SSL — https.
- IP-адрес для подключения к LBcore.
- Логин и пароль от профиля платёжной системы в LANBilling.
```
my $proto = 'http';
my $lbcore_host = '127.0.0.1';
my $manager_login = 'super_pay';
my $manager_pass = '12345';
```
``

Сделайте скрипт исполняемым:

chmod +x /usr/local/www/apache24/cgi-bin/osmp-ckassa.cgi

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

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

Внесите изменения в файл конфигурации ckassa.ini:
```
nano /etc/lanbilling/phpclient/client/ckassa.ini
```
``
- Включите платёжную систему в личном кабинете абонентов LANBilling:
```
[ckassa]
enabled = true
```
- Укажите идентификатор оператора из личного кабинета Ckassa:
```
provider_id = '123-45678-9'
```
- Установите минимальную сумму платежа. Чтобы убрать ограничение, введите «0».
```
minPaymentAmount = 10
```

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

Внесите изменения в файл конфигурации ckassa.ini:
```
nano /usr/local/etc/lanbilling/phpclient/client/ckassa.ini
```
``
- Включите платёжную систему в личном кабинете абонентов LANBilling:
```
[ckassa]
enabled = true
```
- Укажите идентификатор оператора из личного кабинета Ckassa:
```
provider_id = '123-45678-9'
```
- Установите минимальную сумму платежа. Чтобы убрать ограничение, введите «0».
```
minPaymentAmount = 10
```

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

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

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