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

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

  1. Личный кабинет Cloudpayments
  2. Административный интерфейс АСР LANBilling
  3. Скрипт для callback-уведомлений
  4. Конфигурационный файл

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

  1. Зарегистрируйтесь в Cloudpayments. С вами свяжется менеджер и предоставит доступ в личный кабинет.

  2. Для интеграции вам понадобятся два параметра: Public ID и Пароль для API. Чтобы найти их, перейдите на вкладку «Сайты», а затем откройте настройки своего сайта.

    image

    Скопируйте значения из полей «Public ID» и «Пароль для API».

    image
  3. Настройте отправку уведомлений. Для этого включите Pay-уведомления и введите путь до файла cloudpayments.py на вашем веб-сервере.

    image

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

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

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

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

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

  1. Скопируйте файл cloudpayments.py в директорию исполняемых скриптов вашего веб-сервера:

    cp /usr/local/billing/payments/cloudpayments/cloudpayments.py /var/www/cgi-bin/
    

    ``

  2. Укажите в нём настройки доступа.

    • 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'
      
      
      
  3. Сделайте скрипт исполняемым:

    chmod +x /var/www/cgi-bin/cloudpayments.py
    

    ``

  1. Скопируйте файл cloudpayments.py в директорию исполняемых скриптов вашего веб-сервера:

    cp /usr/local/billing/payments/cloudpayments/cloudpayments.py /usr/lib/cgi-bin/
    

    ``

  2. Укажите в нём настройки доступа.

    • 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'
      
      
      
  3. Сделайте скрипт исполняемым:

    chmod +x /usr/lib/cgi-bin/cloudpayments.py
    

    ``

  1. Скопируйте файл cloudpayments.py в директорию исполняемых скриптов вашего веб-сервера:

    cp /usr/local/billing/payments/cloudpayments/cloudpayments.py /usr/local/www/apache24/cgi-bin/
    

    ``

  2. Укажите в нём настройки доступа.

    • 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'
      
      
      
  3. Сделайте скрипт исполняемым:

    chmod +x /usr/local/www/apache24/cgi-bin/cloudpayments.py
    

    ``

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

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

  1. Внесите изменения в файл конфигурации 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
      
      
      

  1. Сохраните конфигурационный файл. Сериализуйте изменения:

    /usr/local/sbin/lbwebcfg -y client /etc/lanbilling/phpclient/client/
    

    ``

  1. Внесите изменения в файл конфигурации 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
      
      
      

  1. Сохраните конфигурационный файл. Сериализуйте изменения:

    /usr/local/sbin/lbwebcfg -y client /usr/local/etc/lanbilling/phpclient/client/
    

    ``

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