Взаимодействие с платёжной системой «Cloudpayments»
Чтобы абоненты-физлица могли оплачивать счета в личном кабинете с помощью Cloudpayments, последовательно настройте четыре объекта.
- Личный кабинет Cloudpayments
- Административный интерфейс АСР LANBilling
- Скрипт для callback-уведомлений
- Конфигурационный файл
Личный кабинет Cloudpayments
-
Зарегистрируйтесь в Cloudpayments. С вами свяжется менеджер и предоставит доступ в личный кабинет.
-
Для интеграции вам понадобятся два параметра: Public ID и Пароль для API. Чтобы найти их, перейдите на вкладку «Сайты», а затем откройте настройки своего сайта.
Скопируйте значения из полей «Public ID» и «Пароль для API».
-
Настройте отправку уведомлений. Для этого включите Pay-уведомления и введите путь до файла cloudpayments.py на вашем веб-сервере.
Административный интерфейс АСР LANBilling
Создайте профиль для платёжной системы в АСР LANBilling.
Скрипт для callback-уведомлений cloudpayments.py
Скрипт нужен, чтобы фиксировать в АСР LANBilling результаты оплат. Он обрабатывает запросы от платёжной системы — в них содержится информация об операциях. На основании этих данных скрипт создаёт платежи в биллинге.
Настройка различается для разных ОС.
-
Скопируйте файл cloudpayments.py в директорию исполняемых скриптов вашего веб-сервера:
cp /usr/local/billing/payments/cloudpayments/cloudpayments.py /var/www/cgi-bin/``
-
Укажите в нём настройки доступа.
-
IP-адрес и порт для подключения к LBcore.
-
Логин и пароль от профиля платёжной системы в АСР LANBilling.
-
Реквизиты для доступа к Cloudpayments — Public ID и Пароль для API.
# Подключение к LBcore HOST = '192.168.49.113' PORT = 1502 MANAGER = 'manager' PASSWORD = '123' # credentials для cloudpayments public_id = '12345' secret = 'f5ef5d04fe05c3e3d7fd1f08748cbf2b'
-
-
Сделайте скрипт исполняемым:
chmod +x /var/www/cgi-bin/cloudpayments.py``
-
Скопируйте файл cloudpayments.py в директорию исполняемых скриптов вашего веб-сервера:
cp /usr/local/billing/payments/cloudpayments/cloudpayments.py /usr/lib/cgi-bin/``
-
Укажите в нём настройки доступа.
-
IP-адрес и порт для подключения к LBcore.
-
Логин и пароль от профиля платёжной системы в АСР LANBilling.
-
Реквизиты для доступа к Cloudpayments — Public ID и Пароль для API.
# Подключение к LBcore HOST = '192.168.49.113' PORT = 1502 MANAGER = 'manager' PASSWORD = '123' # credentials для cloudpayments public_id = '12345' secret = 'f5ef5d04fe05c3e3d7fd1f08748cbf2b'
-
-
Сделайте скрипт исполняемым:
chmod +x /usr/lib/cgi-bin/cloudpayments.py``
-
Скопируйте файл cloudpayments.py в директорию исполняемых скриптов вашего веб-сервера:
cp /usr/local/billing/payments/cloudpayments/cloudpayments.py /usr/local/www/apache24/cgi-bin/``
-
Укажите в нём настройки доступа.
-
IP-адрес и порт для подключения к LBcore.
-
Логин и пароль от профиля платёжной системы в АСР LANBilling.
-
Реквизиты для доступа к Cloudpayments — Public ID и Пароль для API.
# Подключение к LBcore HOST = '192.168.49.113' PORT = 1502 MANAGER = 'manager' PASSWORD = '123' # credentials для cloudpayments public_id = '12345' secret = 'f5ef5d04fe05c3e3d7fd1f08748cbf2b'
-
-
Сделайте скрипт исполняемым:
chmod +x /usr/local/www/apache24/cgi-bin/cloudpayments.py``
Конфигурационный файл cloudpayments.ini
Действия различаются для разных ОС.
-
Внесите изменения в файл конфигурации cloudpayments.ini:
nano /etc/lanbilling/phpclient/client/cloudpayments.ini``
-
Включите платёжную систему в личном кабинете абонентов АСР LANBilling.
enabled = true -
Укажите свой Public ID:
PublicID = 12345 -
Настройте параметры налоговой ставки и метода расчёта:
currency = 'RUB' ; Наименование товарной позиции в свободной форме productName = 'Услуги связи' ; null — НДС не облагается ; 0 — НДС 0% ; 10 — НДС 10% ; 18 — НДС 18% ; 110 — расчетный НДС 10/110 ; 118 — расчетный НДС 18/118 vat = 0 ; Варианты системы налогообложения: ; 0 — Общая система налогообложения ; 1 — Упрощенная система налогообложения (Доход) ; 2 — Упрощенная система налогообложения (Доход минус Расход) ; 3 — Единый налог на вмененный доход ; 4 — Единый сельскохозяйственный налог ; 5 — Патентная система налогообложения tax = 0 ; Способы расчёта: ; 0 — Unknown, неизвестный способ расчета (значение по умолчанию. в электронной форме чека не отображается) ; 1 — FullPrepayment, Предоплата 100% ; 2 — PartialPrepayment, Предоплата ; 3 — AdvancePay, Аванс ; 4 — FullPay, Полный расчёт ; 5 — PartialPayAndCredit, Частичный расчёт и кредит ; 6 — Credit, Передача в кредит ; 7 — CreditPayment, Оплата кредита method = 0 ; Предметы расчёта: ; 0 — Unknown, неизвестный предмет оплаты (значение по умолчанию — в электронной форме чека не отображается) ; 1 — Commodity, Товар ; 2 — ExcisedCommodity, Подакцизный товар ; 3 — Job, Работа ; 4 — Service, Услуга ; 5 — GamblingBet, Ставка азартной игры ; 6 — GamblingWin, Выигрыш азартной игры ; 7 — LotteryTicket, Лотерейный билет ; 8 — LotteryWin, Выигрыш лотереи ; 9 — RidAccess, Предоставление РИД ; 10 — Payment, Платеж ; 11 — AgentReward, Агентское вознаграждение ; 12 — Composite, Составной предмет расчета ; 13 — Another, Иной предмет расчета object = 10
-
-
Сохраните конфигурационный файл. Сериализуйте изменения:
/usr/local/sbin/lbwebcfg -y client /etc/lanbilling/phpclient/client/``
-
Внесите изменения в файл конфигурации cloudpayments.ini:
nano /usr/local/etc/lanbilling/phpclient/client/cloudpayments.ini``
-
Включите платёжную систему в личном кабинете абонентов АСР LANBilling.
enabled = true -
Укажите свой Public ID:
PublicID = 12345 -
Настройте параметры налоговой ставки и метода расчёта:
currency = 'RUB' ; Наименование товарной позиции в свободной форме productName = 'Услуги связи' ; null — НДС не облагается ; 0 — НДС 0% ; 10 — НДС 10% ; 18 — НДС 18% ; 110 — расчетный НДС 10/110 ; 118 — расчетный НДС 18/118 vat = 0 ; Варианты системы налогообложения: ; 0 — Общая система налогообложения ; 1 — Упрощенная система налогообложения (Доход) ; 2 — Упрощенная система налогообложения (Доход минус Расход) ; 3 — Единый налог на вмененный доход ; 4 — Единый сельскохозяйственный налог ; 5 — Патентная система налогообложения tax = 0 ; Способы расчёта: ; 0 — Unknown, неизвестный способ расчета (значение по умолчанию. в электронной форме чека не отображается) ; 1 — FullPrepayment, Предоплата 100% ; 2 — PartialPrepayment, Предоплата ; 3 — AdvancePay, Аванс ; 4 — FullPay, Полный расчёт ; 5 — PartialPayAndCredit, Частичный расчёт и кредит ; 6 — Credit, Передача в кредит ; 7 — CreditPayment, Оплата кредита method = 0 ; Предметы расчёта: ; 0 — Unknown, неизвестный предмет оплаты (значение по умолчанию — в электронной форме чека не отображается) ; 1 — Commodity, Товар ; 2 — ExcisedCommodity, Подакцизный товар ; 3 — Job, Работа ; 4 — Service, Услуга ; 5 — GamblingBet, Ставка азартной игры ; 6 — GamblingWin, Выигрыш азартной игры ; 7 — LotteryTicket, Лотерейный билет ; 8 — LotteryWin, Выигрыш лотереи ; 9 — RidAccess, Предоставление РИД ; 10 — Payment, Платеж ; 11 — AgentReward, Агентское вознаграждение ; 12 — Composite, Составной предмет расчета ; 13 — Another, Иной предмет расчета object = 10
-
-
Сохраните конфигурационный файл. Сериализуйте изменения:
/usr/local/sbin/lbwebcfg -y client /usr/local/etc/lanbilling/phpclient/client/``
Настройка завершена. Теперь абоненты-физлица могут пополнять баланс в личном кабинете с помощью этой платёжной системы.
Есть вопросы по документации? Пожалуйста, напишите их