Настройка взаимодействия с внешними платежными системами.

 
Содержание

    Настройка работы АСР с платежной системой CyberPlat.
    Интеграция с сервисом Transfer для принятия платежей через WebMoney.
    Подключение платежной системы Яндекс.Касса
    Настройка взаимодействия с платежной системой «ROBOKASSA»
    Настройка взаимодействия с платежной системой «PAYMASTER»
    Настройка взаимодействия с платежной системой «PAYMO»
    Настройка взаимодействия с платежной системой «ChronoPay»
    Настройка взаимодействия с платежной системой Сбербанка России
    Настройка взаимодействия с платежной системой «PayOnline»
    Инструкция по настройке платежной системы «Qiwi»
    Настройка интеграции с платежной системой «Центральная Касса»
    Настройка интеграции с платежной системой «Тинькофф Оплата»

Настройка работы АСР с платежной системой CyberPlat.


  1. Установите web-сервер Apache в соответствии с оригинальной инструкцией по установке (для нужд взаимодействия с внешней платежной системой можно использовать также web-сервер Apache, обслуживающий web-интерфейс АСР)

  2. Скопируйте файл /usr/local/billing/payments/cyberplat/cyberplat.cgi в cgi-bin директорию сервера. Так же в директории /usr/local/billing/payments/ расположены скрипты для работы с другими провайдерами электронных платежей. Для работы скрипта необходим Perl модуль SOAP::Lite Файл /usr/local/billing/payments/LB.pm можно оставить в текущей директории, но в некоторых случаях файл LB.pm следует поместить в любую директорию, включенную в переменную @INC интерпретатора Perl. Если сервер LBcore прослушивает не стандартный TCP порт 34012, то следует указать номер порта в переменной $self->_PORT = $args{above.portabove.} || 34012; файла LB.pm

  3. Проверьте права на файлах в директории cgi-bin (файлы должны обладать привилегиями на выполнение для пользователя, под полномочиями которого запущен Apache, но не рекомендуется разрешать запуск скриптов для всех пользователей ОС)

  4. Настройте аутентификацию для доступа к скрипту одним из следующих способов: стандартная аутентификация Apache (через файл .htaccess), и защита данных путем SSL шифрования (X.509, HTTPS)

  5. Создайте в АСР менеджера, с правами ВПС (внешней платежной системы), под учетным именем которого будут поступать платежи через CyberPlat (права в интерфейсе значения не имеют). При этом следует учитывать, что количество зарегистрированных менеджеров с правами ВПС должно быть не больше, чем количество модулей интеграции с ВПС допустимое активированным лицензионным ключом. В скрипте cyberplat.cgi следует указать следующие параметры:

    • my $lbcore_host = 'localhost'; IP-адрес или имя хоста, где запущен сервер LBcore
    • my $manager_login = 'cyberplat'; Логин менеджера в АСР с правами ВПС от которого будут проходить платежи от данной ВПС
    • my $manager_pass = 'cyberplat'; Пароль менеджера, указанного в переменной $manager_ login
    • указать переменную my $type = TYPE_AGRM_NUM; определяющую идентификатор реципиента платежа, по умолчанию – номер договора (TYPE_AGRM_NUM;).

      Список остальных возможных идентификаторов можно увидеть с комментариями в файле /usr/local/billing/payments/LB.pm
  6. После прохождения тестирования шлюза на сервисе CyberPlat система готова к приему платежей.

Интеграция с сервисом Transfer для принятия платежей через WebMoney.


Создание и настройка кошелька WebMoney Merchant

Для работы с сервисами Webmoney необходимо зарегистрироваться на сайте Webmoney. Для приема платежей подойдут версии киппера «Classic» или «Light». Процесс регистрации подробно документирован, ознакомиться с инструкцией можно на сайте WebMoney в процессе регистрации. После завершения регистрации необходимо создать кошелёк в той валюте, в которой Вы хотели бы принимать платежи (WMR — рубли, WMZ — доллары и т.д.).

Настройка Merchant для приема платежей на выбранный WMR кошелёк.

Перейдите по ссылке и нажмите кнопку «Войти». Авторизуйтесь согласно выбранному Вами типу регистрации.

spisok_koshelkov_wm

Выберите кошелёк, на который будут поступать платежи (валюты кошелька и системы LANBilling должны соответствовать), и нажмите «Настроить» справа от выбранного кошелька.

Заполните следующие поля:

  • Отметить галочкой поле «Передавать параметры в предварительном запросе».
  • Торговое имя — название Вашей компании.
  • Secret key — секретное слово-ключ, которое будет учитываться при определении состава контрольной суммы (используется для исключения возможности фальсификации получаемый данных). Информацию о ключе надо также указать в качестве значения константы $secret в разделе 3.2 в файле webmoney.pm.
  • Result Url — адрес страницы webmoney.pm, которую сервис Webmoney Transfer будет вызывать для проверки платежа и оповещения о том, что платёж прошел успешно.
  • Задать адреса Success Url и Fail Url, на которые будет перенаправлен пользователь при успешном и неудавшемся платеже соответственно (метод вызова — POST или другой при необходимости).
  • Если Вы хотите получать уведомления об ошибках платежей, отметьте галочкой соответствующее поле («Высылать оповещение об ошибке платежа на киппер»).
  • Если Вы хотите получать уведомления об ошибках платежей, отметьте галочкой соответствующее поле («Высылать оповещение об ошибке платежа на киппер»).
  • «Метод формирования контрольной подписи» — выбрать MD5.
  • «Тестовый/Рабочий режимы» — для начала установите тестовый режим, чтобы проверить работоспособность приёма платежей через webmoney. При работе в этом режиме на Ваш кошелёк не будут переводиться деньги и не будет происходить пополнение баланса LANBilling. В остальном логика работы интеграции будет задействована в полной мере. Впоследствии режим нужно сменить на рабочий, для чего Вам понадобится «Начальный аттестат» и регистрация в megastock.

С более подробным описанием полей и их значений вы можете ознакомиться на сайте.

Получение «Начального аттестата».

srttings_koshelek_wm

До получения как минимум«Начального аттестата» прием платежей через сервисыWebmoney Transfer невозможен. Процедура аттестации приводится на страницах сервиса Webmoney.

Регистрация в megastock.

После получения«Начального аттестата» необходимо перевести кошелёк в«рабочий» режим приёма денежных средств, пройдя процесс регистрации на сайте MegaStock.

Обобщенная схема принятия платежей через WebMoney

Настройка серверной части LANBilling для приема оповещений о платежах

Интерфейс клиента.

По умолчанию возможность пополнения баланса через Webmoney отключена. Для подключения функции необходимо изменить значение параметра payment_webmoney на true в файле client/client_interface.cfg. После этого в клиентском интерфейсе при выборе пункта меню «Оплата» появится закладка «Оплата через Webmoney».

ris4

Выбрав договор и сумму платежа, клиент должен нажать кнопку «Внести», после чего он будет перенаправлен на страницу merchant.webmoney.ru для совершения платежа. Измените номер кошелька LMI_PAYEE_PURSE на ваш в файле: /etc/lanbilling/phpclient/client/webmoney

Настрока оплаты WebMoney

[paysystems/webmoney]
enabled = true
title = ’WebMoney payment system’
description = ’It is "WebMoney" payment section, where you can refill your balance using "WebMoney" payment system’
url = ’https://merchant.webmoney.ru/lmi/payment.asp’
method = ’post’

[paysystems/webmoney/request/helper] alias=application.components.paysystems.components.Paysystems_DescrBase64 method=request

[paysystems/webmoney/request/params] LMI_PAYMENT_AMOUNT = ’{amount}’ LMI_PAYEE_PURSE = ’R49812459874’ LMI_PAYMENT_NO = ’1234’ LMI_SIM_MODE = 0 LB_CONTRACT_NUMBER = ’{agrmnum}’

Сериализуйте изменения

CentOS 6–7/Debian 8–9

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

FreeBSD 10/11

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

Подготовка сервера для приема оповещений о платежах.

schema_wm.png

При настройке магазина в качестве Result Url необходимо указать путь к Вашему скрипту webmoney.pm, содержащему логику проверки платежей и начисления средств на счет пользователя в случае поступления средств.

Настройте значения следующих полей:

Название переменной Описание Пример значения
$lbcore_host IP

Адрес расположения ядра.

127.0.0.1

$manager_login

Логин для авторизации скрипта при работе с ядром (учётная запись добавляется в администраторском интерфейсе меню «Объекты-Менеджеры», с пометкой «Внешняя платёжная система»).

webmoney

$manager_pas

Пароль для авторизации скрипта.

webmoney

$ownerCorrectPurse

Номер вашего кошелька, на который будут поступать средства (используется для проверки реквизитов платежа).

R112233445566

$secret

Секретное слово, которое используется при подсчете контрольной суммы для проверки данных платежа. Данное слово обязаны знать только Вы и merchant.webmoney.

BigSecret

Установка дополнительных модулей на сервере.

На сервере необходимо установить дополнительные модули:

  • SOAP/Lite
  • Digest/MD5 (p5-Digest-MD5)

Настройка взаимодействия с платежной системой «Яндекс.Касса»


  1. Обмен информационными сообщениями происходит с применением контрольной суммы «md5». Для её формирования необходимо придумать секретное слово и заполнить анкету.

  2. После заполнения анкеты и заключения договора с ООО НКО «Яндекс.Касса» вам будут переданы shopID, scID.

  3. Для работы скрипта конвертации потребуются модули языка PERL:

    • SOAP/Lite
    • CGI
    • Digest/MD5
    Модули можно установить например, через CPAN либо из стороннего репозитория(например, репозитарий RPM FORGE).

  4. Скрипт является CGI сценарием, поэтому для его работы необходимы соответствующие настройки веб-сервера, которые выходят за рамки данной инструкции.

  5. В скрипте необходимо указать (в секции «# Атрибуты доступа к LBcore») верные логин, пароль, хост для подключения к LBcore. В настройках указанного менеджера должна быть включена опция «Внешняя платежная система».

  6. Установите значение переменной $shopPassword равной секретному слову из пункта 1.

  7. Скопируйте скрипт в директорию, где возможно выполнение cgi-сценариев. По умолчанию находится в директории /usr/local/billing/payments/yandex. Дайте скрипту права на исполнение:
    #chmod +x kassa.py

  8. Внесите изменения в конфигурационный файл клиентского интерфейса /etc/lanbilling/phpclient/client/yandexCheckout.ini:

    Настройка Yandex Money

    [yandexCashbox]
    enabled = true
    shopId = 92
    scid = 20375
    operatorURL = ’https://demomoney.yandex.ru/eshop.xml’
    text = ’Provider service’
    ;1 – без НДС
    ;2 – НДС по ставке 0%
    ;3 – НДС чека по ставке 10%
    ;4 – НДС чека по ставке 20%
    ;5 – НДС чека по расчетной ставке 10/110
    ;6 - НДС чека по расчётной ставке 20/120

    • Включите возможность проведения платежей через Яндекс.Касса.
      enabled = true
    • Установите значения, которые сообщили вам сотрудники Яндекс.Касса.
      shopID = 92,
      scID = 20375
      
    • Для работы на продуктиве закомментируйте строку с параметром operatorURL.
      ;operatorURL = ’https://demomoney.yandex.ru/eshop.xml’

    • И добавьте строку
    • operatorURL = ’https://money.yandex.ru/eshop.xml’

Сериализуйте изменения

CentOS 6–7/Debian 8–9

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

FreeBSD 10/11

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

Важно! После включения возможности проведения платежей в настройках клиентского интерфейса всем абонентам будет доступна эта возможность. Рекомендуется проверить функциональность на тестовом стенде до включения в продуктив.

Пример заполнения анкеты.

Чтобы подключить Ваш магазин, сотрудники Яндекс.Касса должны выполнить ряд настроек, и для них нужны данные из этой анкеты. Пожалуйста, заполните ее и отправьте им по электронной почте.

Наименование магазина

Название, которое будет пользователь во время платежа.
Адрес сайта

http://site.ru
CMS (Система управления сайтом)

Самописный сайт
Адрес для уведомлений*

URL, по которому Ваш магазин будет отвечать на запросы «Проверка заказа». Максимальная длина URL – 200  зн., только https*
Email для реестров

Укажите, на какой адрес мы должны отправлять ежесуточные реестры принятых платежей.

Расшифровка:

  • Наименование магазина - отображается в контракте платежной системы и истории платежей пользователя.
  • Адрес сайта - адрес вашего сайта, пример: https://companyname.com
  • CMS - Система управления сайтом.
  • Адрес для уведомлений* - указывается скрипт:

    https://companyname.com/cgi-bin/yandex/kassayandex.pl
  • Email для реестров - адрес электронной почты, на который будут приходить ежесуточные реестры принятых платежей.

Внимание! Компания Яндекс рекомендует переходить на новый протокол приема платежей. Для осуществления перехода необходимо обратиться к компании Яндекс.

Настройка взаимодействия с платежной системой «ROBOKASSA»


Регистрация на сайте провайдера

Для начала работы с системой приема электронных платежей «ROBOKASSA» необходимо осуществить регистрацию на сайте провайдера:по адресу.

Примечание: С подробным описанием процесса регистрации на сайте провайдера электронных платежей «ROBOKASSA» и работы с интерфейсами сервиса можно ознакомиться по адресу:docs.robokassa.ru

Далее, в разделе «Технические настройки» следует заполнить соответствующую форму:

settings_rk
Примечание: По умолчанию, в АСР LANBilling, используются следующие адреса веб-страниц, на которые происходит переадресация пользователя в случае успешной оплаты (параметр «Success Url») и в случае отказа от оплаты (параметр «FailUrl»):
  • https://ip_adress_of_www_server/lbweb-client/api.php?r=payment/success
  • https://ip_adress_of_www_server/lbweb-client/api.php?r=payment/fail

Настройка АСР LANBilling

Для настройки взаимодействия АСР LANBilling с сервисом приема электронных платежей «ROBOKASSA» необходимо осуществить следующие действия:

  1. В административном веб-интерфейсе добавить нового менеджера (пункт меню «Объекты» — «Менеджеры», кнопка «Добавить менеджера»), отметить флаг «Внешняя платежная система», задать его «Логин» и «Пароль».
  2. rk_lan_role

  3. В конфигурационном файле «/etc/lanbilling/phpclient/client/robokassa.ini» прописать параметры доступа к сервису «ROBOKASSA», указанные на этапе регистрации на сайте провайдера
  4. ; Настройка оплаты Robokassa
    
    [paysystems/robokassa]
    enabled = true
    title = ’Robokassa payment’
    description = ’It is section, where you can refill you balance using Robokassa payment system’
    url = ’https://merchant.roboxchange.com/Index.aspx’
    method = ’post’

    [paysystems/robokassa/request/helper] alias = ’application.components.paysystems.components.Paysystems_Robokassa’ method = ’request’

    [paysystems/robokassa/request/helper/options] password = ’password_1’

    ; Система налогообложения
    ; ; "osn" – общая СН ; "usn_income" – упрощенная СН (доходы) ; "usn_income_outcome" – упрощенная СН (доходы минус расходы) ; "envd" – единый налог на вмененный доход ; "esn" – единый сельскохозяйственный налог ; "patent" – патентная СН

    sno = ’osn’

    ;Наименование товара. Строка, максимальная длина 64 символа name = ’Provider service’ ; Это поле устанавливает номер налога в ККТ. Определяется для каждого вида товара по отдельности,
    но за все единицы конкретного ; "none" – без НДС ; "vat0" – НДС по ставке 0% ; "vat10" – НДС чека по ставке 10% ; "vat20" – НДС чека по ставке 20% ; "vat110" – НДС чека по расчетной ставке 10/110 ; "vat120" – НДС чека по расчетной ставке 20/120 ; tax = ’none’

    ; Признак способа расчёта ; Возможные значения параметра - https://docs.robokassa.ru/#6865 payment_method = 'full_payment'

    ; Признак предмета расчёта ; Возможные значения параметра - https://docs.robokassa.ru/#6865 payment_object = 'service'

    [paysystems/robokassa/request/params] MrchLogin = ’demo’ OutSum = ’{amount}’ InvId = 0 Shp_agrmid = ’{agrmid}’

    где:

    • «url» — путь доступа к сервису «ROBOKASSA»;
    • «password» — пароль, соответствующий значению поля «Пароль #1» формы «Технические настройки», заполняемой на этапе регистрации на сайте провайдера.
    • «MrchLogin» — идентификатор магазина, указанный на этапе регистрации на сайте провайдера.

    Примечание: в режиме тестирования работоспособности сервиса следует использовать параметр 'url' => 'http://test.robokassa.ru/Index.aspx'.

    Сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

  5. В настройках скрипта «robokassa.cgi» указать параметры подключения к LBcore, включая логин и пароль созданного менеджера ВПС, а так же пароль, указанный на этапе регистрации на сайте провайдера:
  6. # Атрибуты для доступа к Lbcore
    my $proto = 'http';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'robokassa';
    my $manager_pass = 'robokassa';
    ...
    my $mrh_pass2 = "password #2";
    

    Примечание: Значение «password #2» соответствует значению поля «Пароль #2» формы «Технические настройки», заполняемой на этапе регистрации на сайте провайдера.

Для тестирования взаимодействия АСР LANBilling с сервисом приема электронных платежей «ROBOKASSA» необходимо осуществить платеж из личного кабинета пользователя. При этом будет открыт тестовый интерфейс оплаты.
Нажатие кнопки «Go» в разделе «Payment notification» должно привести к проведению платежа и его отображению в веб-интерфейсе АСР LANBilling.
Раздел «Successful and fail payment» тестового интерфейса оплаты проверяет работу переадресации пользователя в случае успешной оплаты и в случае отказа от оплаты.

Активация сервиса приема электронных платежей «ROBOKASSA»

После регистрации, первоначальных настроек и успешного проведения тестовых операций необходимо активировать сервис приема электронных платежей «ROBOKASSA». Для этого следует провести активацию на сайте провайдера (http://docs.robokassa.ru), а затем в конфигурационном файле /etc/lanbilling/phpclient/client/robokassa.ini изменить параметр «url»:

url = ’https://merchant.roboxchange.com/Index.aspx’

Настройка взаимодействия с платежной системой «PAYMASTER»


Регистрация Магазина на сайте провайдера.

  1. Для начала работы с системой приема электронных платежей «PAYMASTER» необходимо заполнить анкету на сайте провайдера по адресу: paymaster.ru
  2. После получения логина и пароля в Личном кабинете PayMaster производится настройка:
  3. Для проведения платежей,необходимо создать менеджера внешней платежной системы (ВПС) в административном веб-интерфейсе АСР LANBilling
  4. Например:
    Логин: paymaster
    Пароль: paymaster

  5. В конфигурационном файле /etc/lanbilling/phpclient/client/paymaster.ini прописываются необходимые параметры:
  6. ; Настройка оплаты Paymaster
    [paysystems/paymaster]
    enabled = true
    title = ’PayMaster payment system’
    description = ’It is "PayMaster" payment section, where you can refill your
    balance using "PayMaster" payment system’ url = ’https://paymaster.ru/Payment/Init’ method = ’get’

    [paysystems/paymaster/request/helper] alias=’application.components.paysystems.components.Paysystems_Paymaster’ method=’request’

    [paysystems/paymaster/request/params] LMI_PAYMENT_AMOUNT = ’{amount}’ LMI_MERCHANT_ID = ’R2058490398590’ LMI_PAYMENT_NO = ’{agrmid}’ LMI_SIM_MODE = 0 LB_CONTRACT_NUMBER = ’{agrmnum}’ LMI_CURRENCY = ’RUB’ LMI_PAYER_EMAIL = ’{email}’ LMI_PAYER_PHONE_NUMBER = ’{mobile}’

    ; Настройки для поддержки ФЗ-54 [paysystems/paymaster/request/options] ... PRODUCT_NAME = ’Provider service’ ... TAX = ’no_vat’

    • «PRODUCT_NAME» – наименование поставщика услуг. Значение будет отображено в чеке.
    • «TAX» – ставка НДС. Допустимы значения:
      vat20 – НДС 20%;
      vat10 – НДС 10%;
      vat120 – НДС по формуле 20/120;
      vat110 – НДС по формуле 10/110;
      vat0 – НДС 0%;
      no_vat – НДС не облагается;
    • «LMI_MERCHANT_ID» – идентификатор поставщика услуг платежной системы на стороне Paymaster.
    • Параметр «LMI_SIM_MODE» = 0 работает только в режиме тестирования. Когда Магазин будет переведен в Рабочий режим, этот параметр будет отбрасываться.
    • «LMI_CURRENCY» – сокращенное наименование валюты, в которой будут происходить платежи.
    • Важно: Для корректного формирования чека в соответствии с поправками к ФЗ-54 номер телефона абонента должен начинаться с цифры «7» без знака «+». Например,

      79123456789 -- корректный формат.
      +79123456789 -- некорректный формат.

      Сериализуйте изменения

      CentOS 6–7/Debian 8–9

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

      FreeBSD 10/11

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

  7. В скрипте paymaster.cgi указываются настройки подключения к LBcore, включая логин и пароль созданного менеджера ВПС, а так же секретный ключ, придуманный в п. 2:

    # Атрибуты для доступа к Lbcore
    my $proto = 'http';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'paymaster';
    my $manager_pass = 'paymaster';
    ...
    my $secret_key = "secret_key";
    
  8. Для проведения тестовых платежей необходимо воспользоваться существующим WM-кошельком. Денежные средства с кошелька во время тестирования списываться не будут. С подробностями тестового режима можно ознакомиться по ссылке

    Замечания: для работы скрипта paymaster.cgi необходимы следующие модули PERL:

    • Digest::MD5
    • MIME::Base64
    • SOAP::Lite
    • Compress::Zlib

Настройка взаимодействия с платежной системой «PAYMO»


Регистрация на сайте провайдера

Для начала работы с системой приема электронных платежей «PAYMO» необходимо осуществить регистрацию на сайте провайдера по адресу: https://paymo.ru/

Далее, в настройках созданного магазина следует прописать следующие параметры:

  • Callback до создания оплаты = http://yourcompany.org/cgi-bin/paymo/start.cgi;
  • Callback после подтверждения оплаты = http://yourcompany.org/cgi-bin/paymo/finish.cgi;
  • Старый ключ = oldkey;
  • Новый ключ = newkey.

Для завершения регистрации на сайте провайдера необходимо сохранить сделанные изменения и получить «API-key». Для этого следует перейти по ссылке «PAYMO.Air», напротив названия магазина, и нажать кнопку «Запросить API-Key».

Настройка АСР LANBilling

Для настройки взаимодействия АСР LANBilling с сервисом приема электронных платежей «PAYMO» необходимо осуществить следующие действия:

  1. В административном веб-интерфейсе добавить нового менеджера (пункт меню «Объекты» — «Менеджеры», кнопка «Добавить менеджера»), отметить флаг «Внешняя платежная система», задать его «Логин» и «Пароль»

  2. В конфигурационном файле «/etc/lanbilling/phpclient/client/paymo.ini» прописать параметры доступа к сервису «PAYMO», полученные на этапе регистрации на сайте провайдера:

    ; Настройка PAYMO
    [paymo]
    enabled = true
    key = ’420ff608-2755-4fc5-8cab-c34a5c268264’
    description = ’Платеж в магазине demo PAYMO air’
    merchandise = ’Пополнение счета’
    managerid = 0
    jssdk = ’https://paymo.ru/static/rest/js/paymo_init_frame.js’
       

    где:

    • «key» — полученный на этапе регистрации «API-key»;
    • «description» — описание операции;
    • «merchandise» — назначение платежа;
    • «managerid» — ID созданного менеджера «PAYMO»;
    • «jssdk» — путь доступа сервису «PAYMO».

    Примечание: в режиме тестирования работоспособности сервиса следует использовать параметр 'jssdk' => 'https://paymo.ru:444/static/rest/js/sdk.js'

    Сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

  3. Скопировать скрипты «start.cgi» и «finish.cgi» в директорию, в которой настроено и разрешено выполнение cgi-сценариев. Указать в них параметры подключения к LBcore, включая логин и пароль созданного менеджера ВПС.

    # Атрибуты для доступа к Lbcore
    my $proto = 'http';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'paymo';
    my $manager_pass = 'paymo';
    

    Для тестирования взаимодействия АСР LANBilling с сервисом приема электронных платежей «PAYMO» необходимо осуществить платеж из личного кабинета пользователя. При этом будет открыт интерфейс оплаты «PAYMO»

Активация сервиса приема электронных платежей «PAYMO»

После регистрации, первоначальных настроек и успешного проведения тестовых операций необходимо активировать сервис приема электронных платежей «PAYMO». Для этого, в файле настроек «Paymo» следует изменить параметр «jssdk»:

jssdk = ’https://paymo.ru/static/rest/js/paymo_init_frame.js’

Настройка взаимодействия с платежной системой «ChronoPay»


«ChronoPay» — ведущий оператор интернет-платежей с помощью банковских карт, является глобальной платформой для обработки платежей в сети Интернет по всему миру. Сегодня компания представляет собой холдинг с представительствами в нескольких странах и предлагает услуги по организации приема онлайн-платежей для всех сфер бизнеса посредством большинства платежных инструментов.

Подключение к «ChronoPay»

Подробная информация о процедуре подключения к сервису «ChronoPay» изложена на сайте оператора на странице«Как подключиться»

Важно После получения, от менеджеров оператора, электронного письма с регистрационными данными и конфигурационными параметрами следует убедиться, что в клиентском интерфейсе «ChronoPay» магазин находится в статусе «Active».

Настройка АСР LANBilling

Для настройки взаимодействия АСР LANBilling с сервисами оператора интернет-платежей «ChronoPay» необходимо осуществить следующие действия:

  1. В административном веб-интерфейсе добавить нового менеджера (пункт меню «Объекты» — «Менеджеры», кнопка «Добавить менеджера»), отметить флаг «Внешняя платежная система», задать его «Логин» и «Пароль»

  2. В конфигурационном файле «/etc/lanbilling/phpclient/client/chronopay.ini»:

    ; Настройки способа оплаты Chronopay
    [paysystems/chronopay]
    enabled = true
    title = "ChronoPay payment system"
    description = ’It is "ChronoPay" payment section, where you can refill your 
    balance using "ChronoPay" payment system’ url = ’https://payments.chronopay.com/’ method = ’post’ orangedata_enable = false

    [paysystems/chronopay/request/helper] alias = ’application.components.paysystems.components.Paysystems_Chronopay’
    method = ’request’

    [paysystems/chronopay/request/helper/options] sharedsec = ’2507AAB01384F932FD738’

    [paysystems/chronopay/request/params] product_id = 000000-0000-0000 product_price = ’{amount}’ cs1 = ’{agrmid}’ cb_url = ’https://site.com’ success_url = ’{success}’ decline_url = ’{fail}’ ; ; Система налогообложения ; ; 1 – общая СН ; 2 – упрощенная СН (доходы) ; 3 – упрощенная СН (доходы минус расходы) ; 4 – единый налог на вмененный доход ; 5 – единый сельскохозяйственный налог ; 6 – патентная СН ; taxSystem = 1 ; ; 1 - НДС 20% ; 2 - НДС 10% ; 3 - НДС расч. 20/120 ; 4 - НДС расч. 10/110 ; 5 - НДС 0% ; 6 - НДС не облагается ; tax’ => 1 ; Имя продукта text = ’Product name’

    активизировать сервис «ChronoPay», прописать параметры доступа к нему, полученные на этапе регистрации и указать путь к файлу скрипта «chronopay.cgi»:

    ; Настройки способа оплаты Chronopay
    [paysystems/chronopay]
    enabled = true
    ...
    [paysystems/chronopay/request/helper/options]
    sharedsec = ’2507AAB01384F932FD738’

    [paysystems/chronopay/request/params] product_id = 000000-0000-0000 ... cb_url = ’https://{IP-адрес сервера АСР}/cgi-bin/chronopay.cgi’

    Сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

  3. Скопировать файл скрипта «chronopay.cgi» в директорию, в которой настроено и разрешено выполнение cgi-сценариев. Указать в нем параметры подключения к LBcore, включая логин и пароль созданного менеджера ВПС, а также секретный ключ, полученный на этапе регистрации в электронном письме от оператора «ChronoPay» (параметр «my $sharedsec»).

    # Атрибуты для доступа к Lbcore
    my $proto = 'http';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'chronopay';
    my $manager_pass = 'chronopay';
    my $sharedsec = "kokfa3578fhjqab72";
    

Тестирование сервиса «ChronoPay» и переход на «боевой» режим.

Для проведения тестовых платежей следует воспользоваться данными карт, предоставленными менеджером оператора «ChronoPay» в электронном письме с регистрационной информацией.

Примечание: При тестировании сервиса через клиентский интерфейс «ChronoPay» параметру «access_url» присвоено значение «http://chronopay.com/» (см. раздел «Настройки продукта»), изменять которое нет необходимости т.к. нужный URL передается в параметре «success_url» при каждом запросе на платеж.

Запуск сервиса в рабочий или «боевой» режим осуществляется специалистами «ChronoPay». Для инициализации данного процесса необходимо получить соответствующие данные от банкаэквайера и подтвердить свою готовность специалистам оператора.

Важно Тестирование сервиса в «боевом» режиме невозможно!!!

Настройка взаимодействия с платежной системой Сбербанка России

Для подключения к сервису приема платежей Сбербанка России необходимо:

  1. Зарегистрировать интернет-магазин в системе онлайн-платежей Сбербанка России (в соответствии с требованиями банка).
  2. Получить у менеджера Сбербанка РФ параметры для настройки сервиса приема платежей:

    • API — lbtest-api;
    • Оператор — lbtest-operator;
    • Пароль — lbtest-lbtest.
  3. В административном веб-интерфейсе АСР LANBilling добавить нового менеджера (пункт меню «Объекты» — «Менеджеры», кнопка « Добавить менеджера»), отметить флаг «Внешняя платежная система», задать его «Логин» и «Пароль», например, «sberbank:sberbank»

  4. В конфигурационном файле «/etc/lanbilling/phpclient/client/sberbank.ini» прописать параметры доступа к сервису приема платежей Сбербанка России, полученные на этапе регистрации:

    ; Настройки "Сбербанк"
    [sberbank]
    enabled = true
    path = ’https://3dsec.sberbank.ru/payment/rest/’
    userName = ’lblogin’
    password = ’24g2I24geskKgeh’
    currency = 643
    language = ’ru’
    pageView = ’DESKTOP’
    sessionTimeoutSecs = 600
    ;Наименование или описание товарной позиции в свободной форме
    bundleItemName = ’Provider service’
    ;Мера измерения количества товарной позиции
    measure = ’шт’
    ;0 – без НДС
    ;1 – НДС по ставке 0%
    ;2 – НДС чека по ставке 10%
    ;3 – НДС чека по ставке 18%	
    ;4 – НДС чека по расчетной ставке 10/110
    ;5 – НДС чека по расчетной ставке 18/118
    ;6 - НДС чека по ставке 20%;
    ;7 - НДС чека по расчётной ставке 20/120.
    

    Сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

  5. Скопировать скрипт «sber_acq.cgi» в папку, настроенную на выполнение cgi-сценариев, дать скрипту права на исполнение:

    # cp sber_acq.cgi /var/www/cgi-bin/
    # chmod +x /var/www/cgi-bin/sber_acq.cgi
  6. Указать в скрипте настройки подключения к LBcore, включая логин и пароль созданного менеджера ВПС:
  7. # Атрибуты для доступа к LBcore
    my $proto = 'http';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'sberbank';
    my $manager_pass = 'sberbank';
    

  8. Выслать сотруднику Сбербанка России, на электронную почту «rbssupport@bpc.ru», URL для callback-уведомлений, например:

    https://company.org/cgi-bin/sber_acq.cgi	
    

    Примечание: Подробную информацию о взаимодействии со Сбербанком России можно получить у менеджеров банка.

  9. Провести тестовые платежи, используя реквизиты тестовых карт:

    Примечание: в качестве параметра «Cardholder name» следует использовать не менее двух слов, набранных латинскими буквами.

    Для карт, вовлеченных в технологию «3DSecure» (veres=y, pares=y или a) код на странице ACS - 12345678.

    pan: 4111 1111 1111 1111
    exp date: 2015/12
    cvv2: 123
    3dsecure: veres=y, pares=y

    pan: 6011 0000 0000 0004 exp date: 2015/12 cvv2: 123 3dsecure: veres=Y pares=A

    pan: 5555 5555 5555 5599 exp date: 2015/12 cvv2: 123 3dsecure: veres=n

    pan: 6390 0200 0000 000003 exp date: 2015/12 cvv2: 123(необязательный параметр) 3dsecure: veres=y, pares=a

    Карты, возвращающие ошибки:

    pan: 5555 5555 5555 5557
    exp date: 2015/12
    cvv2: 123
    3dsecure: veres=y, pares=u
    Declined. PaRes status is U (-2011)

    pan: 4000 0000 0000 0002 exp date: 2015/12 cvv2: 123 3dsecure: veres=u Declined. VeRes status is U (-2016)

    pan: 4444 3333 2222 1111 exp date: 2015/12 cvv2: 123 3dsecure: veres=y, pares=u Declined. PaRes status is U (-2011)

    pan: 5555 5555 4444 4442 exp date: 2015/12 cvv2: 123 3dsecure: veres=u Declined. VeRes status is U (-2016)

    pan: 4444 4444 4444 4422 exp date: 2015/12 cvv2: 123 Invalid message format (913)

    pan: 4444 4444 1111 1111 exp date: 2015/12 cvv2: 123 Network refused transaction (5)

    pan: 4444 4444 4444 6666 exp date: 2015/12 cvv2: 123 BLOCKED_BY_LIMIT (-20010)

    pan: 4444 4444 4444 4455 exp date: 2015/12 cvv2: 123 Card limitations exceeded (902)

    pan: 4444 4444 9999 9999 exp date: 2015/12 cvv2: 123 TDSEC_COMM_ERROR (151017)

    pan: 4444 4444 4444 3333 exp date: 2015/12 cvv2: 123 Limit exceeded (123)

    pan: 4408 8962 5320 5448 exp date: 2015/12 cvv2: 123 Not enough money (116)

    pan: 4012 8888 8888 1881 exp date: 2015/12 cvv2: 123 RESPONSE_TIMEOUT(151019)

    pan: 4563 9601 2200 1999 exp date: 2015/12 cvv2: 123

  10. Примечание: Согласно требованиям PCI DSS поддержка протоколов TLS 1.0 и TLS 1.1 была отключена на стороне Сбербанк в промышленной среде 29.09.2016 в 11:20. В настоящее время работы с платежами через Сбербанк-онлайн необходима поддержка протокола TLS 1.2, чтобы обновить протокол необходимо выполнить следующие команды:

    CentOS:

    sudo yum update openssl libcurl
    sudo yum update nspr nss-softokn nss-util nss curl

    После этого требуется перезагрузить веб-сервер Apache. Перезагрузка веб-сервера производится с помощью команды:

    CentOS 6:

    service httpd restart

    Debian 7:

    service apache2 restart

    CentOS 6:

    systemclt restart httpd

    Debian 8-9:

    systemclt restart apache2

Настройка взаимодействия с платежной системой «PayOnline»

Регистрация на сайте провайдера.

Для начала работы с системой приема электронных платежей «PayOnline» необходимо осуществить регистрацию на сайте провайдера и получить доступ к «Личному кабинету».

Далее, в настройках созданного магазина, на вкладке «Параметры интеграции» следует прописать параметры:

Настройка АСР LANBilling

Для настройки взаимодействия АСР LANBilling с сервисом приема электронных платежей «PayOnline» необходимо осуществить следующие действия:

  1. В административном веб-интерфейсе добавить нового менеджера (пункт меню «Объекты» — «Менеджеры», кнопка «Добавить менеджера»), отметить флаг «Внешняя платежная система», задать его «Логин» и «Пароль»

  2. В конфигурационном файле «/etc/lanbilling/phpclient/client/payOnline.ini» прописать параметры доступа к сервису «PayOnline», полученные на этапе регистрации на сайте провайдера:
  3. ; Настройки PayOnline
    [PayOnline]
    ; Доступность платежной системы
    enabled = true
    ; Указываем локализацию (доступно ru | en | fr)
    Language’ = ’en’
    ; Указываем идентификатор мерчанта
    MerchantId’ = 57211
    ; Указываем приватный ключ (см. в ЛК PayOnline
    в разделе Сайты -> настройка -> Параметры интеграции) PrivateSecurityKey = ’3df0c3fa-de74-4548-8a5f-910883691c6f’ ; Валюта (доступны следующие валюты | USD, EUR, RUB) Currency’ = ’RUB’ ; Описание заказа (не более 100 символов, запрещено использовать: адреса сайтов, email-ов и др.)
    необязательный параметр OrderDescription’ = ’Пополнение счета’ ; Позволять пользователю выбрать способ оплаты allowChoosePaymentType’ = true

    где:

    • «Language» — Локализация (доступно ru | en | fr);
    • «MerchantId» — Идентификатор магазина;
    • «PrivateSecurityKey» — Приватный ключ
    • «Currency» — Валюта платежа (доступны валюты | USD, EUR, RUB);
    • «OrderDescription» — Необязательный параметр «Описание платежа» (не более 100 символов, запрещено использовать: адреса сайтов, электронной почты и др.).

    Сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

Инструкция по настройке платежной системы «Qiwi»

  1. После регистрации и активации магазина в настройках личного кабинета QIWI в ЭФ «Протоколы»(пункт меню «Настройки» – «Протоколы») необходимо сгенерировать "API ID" и включить протоколы HTTP и Pull(REST). Дополнительно необходимо включить уведомления и указать путь к скрипту https://company.org/cgi-bin/qiwi/wallet.cgi. Требуется также сменить пароль для оповещения – он будет являться ключом hmac_sha1 для проверки подписи. Последним этапом настройки в ЛК «Qiwi» является необходимость включения подписи для уведомлений.
  2. В административном WEB-интерфейсе АСР необходимо создать менеджера ВПС для проведения платежей.
  3. В конфигурационном файле /etc/lanbilling/phpclient/client/qiwi.ini измените параметр from:
  4. ; Настройка платежной системы QIWI
    [paysystems/qiwi]
    enabled = true
    title = ’Visa QIWI Wallet’
    description = ’It is section, where you can refill you
    balance using Visa QIWI Wallet payment system’ url = ’https://w.qiwi.com/order/external/create.action’ method = ’get’

    [paysystems/qiwi/request/params] txn_id = ’{prepayment}’ from = ’2398139892’ to = ’’ summ = ’{amount}’ currency = ’RUB’ successUrl = ’{success}’ failUrl = ’{fail}’

    [paysystems/qiwi/fields/0] type = ’text’ name = ’to’ label = ’Phone’

    from-- ID проекта из кабинета QIWI в меню «Настройки» — «Протоколы». В качестве значения параметра comm можно указать комментарий к проводимому платежу в виде текстового сообщения и переменных. Разрешено использовать следующие переменные:

    • {amount} – сумма платежа;
    • {agrmnum} — Номер договора;
    • {agrmid} — ID договора;
    • {email} — адрес электронной почты абонента;
    • {prepayment} — ID созданной записи таблицы «prepayment».

    Пример:

    В качестве значения параметра comm можно указать: ’Платеж на лицевой сечет номер agrmnum’. Тогда в комментарий к платежу будет добавлена соответствующая информация, а переменная agrmnum будет хранить в себе номер договора, по которому осуществляется платеж.

    После редактирования файла сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

  5. Далее необходимо скопировать скрипт wallet.cgi в ту директорию, в которой настроено выполнение cgi-сценариев. И сделать этот скрипт исполнимым:
  6. # cp wallet.cgi /var/www/cgi-bin/
    # chmod +x /var/www/cgi-bin/wallet.cgi

  7. В wallet.cgi необходимо указать настройки подключения к ядра АСР, включая логин и пароль созданного менеджера ВПС.
  8. # Атрибуты для доступа к LBcore
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'wallet';
    my $manager_pass = 'wallet';/p>
    my $sha1_key = ''; # ключ hmac_sha1 из п. 1 данной инструкции
    

    Важно: QIWI Wallet не имеет тестового режима, все платежи реальны.

Настройка интеграции с платежной системой «Центральная Касса»


Для настройки взаимодействия АСР LANBilling с сервисом приема электронных платежей «Центральная Касса» необходимо отредактировать файл конфигурации:

CentOS 6–7/Debian 8–9

/etc/lanbilling/phpclient/client/ckassa.ini

Пример конфигурационного файла:

[ckassa]
enabled = true
provider_id = '000-00000-0'

Где:

  • enabled = true - Включить возможность проведения платежей через «Центральная Касса»
  • provider_id - идентификатор провайдера услуг.
  • Примечание: Параметр «provider_id» можно узнать через поиск по названию провайдера на сайте https://ckassa.ru, после перехода на форму оплаты найденного провайдера, адресная строка примет вид:

    пример: https://ckassa.ru/payment/#!search_provider/pt_search/000-00000-0/pay,
    где числовое обозначение (000-00000-0) будет являться значением параметра «provider_id».

    Так же необходимо установить пакеты для PERL

    CentOS 6–7

    yum install -y perl-SOAP-Lite perl-CGI

    Debian 8–9

    apt get install -y perl-SOAP-Lite perl-CGI

    Затем нужно применить изменения

    CentOS 6–7/Debian 8–9

    lbwebcfg -y client /etc/lanbilling/phpclient/client
    

    на этом настройка интеграции с сервисом «Центральная Касса» завершена.

    Настройка интеграции с платежной системой «Тинькофф Оплата»

    Для подключения сервиса «Тинькофф Оплата» необходимо перейти на сайт и заполнить заявку на интернет-эквайринг.

    После получения нужной информации от сотрудников Тинькофф, можно приступать к настройке взаимодействия с АСР LANBilling, для этого необходимо отредактировать файл конфигурации:

    CentOS 6–7/Debian 8–9

    /etc/lanbilling/phpclient/client/tinkoff.ini
    

    Пример конфигурационного файла:

    [tinkoff]
    enabled = true
    terminalKey = 'Test'
    operatorURL = 'https://securepay.tinkoff.ru/v2/Init'
    ;Наименование товарной позиции в свободной форме
    text = 'Provider service'
    ;Код валюты ISO 4217 (например, 643).
    ;Если передан Currency, и он разрешен для Продавца,
    ;то транзакция будет инициирована в переданной валюте.
    ;Иначе будет использована валюта по умолчанию для данного терминала.
    currency = 643
    ;Ставка налога Перечисление со значениями:
    ;  'none' – без НДС;
    ;  'vat0' – НДС по ставке 0%;
    ;  'vat10' – НДС чека по ставке 10%;
    ;  'vat110' – НДС чека по расчетной ставке 10/110;
    ;  'vat20' – НДС чека по ставке 20%;
    

    Где:

    • enabled = true - активация возможности проведения платежей.
    • terminalKey - идентификатор терминала, выдается Продавцу Банком.
    • operatorURL - путь доступа к сервису.
    Затем скопируйте скрипты "tinkoff.py" и "tinkoff_auto_charge.py" находятся в директории:
    /usr/local/billing/payments/tinkoff
    
    в директорию, где возможно выполнение cgi-сценариев.

    Внесите нужные изменения:

    "tinkoff.py" скрипт для проведения платежей.

    # Параметры подключения к LBcore
    
    HOST = ''
    PORT = ''
    MANAGER = ''
    PASSWORD = ''
    

    "tinkoff_auto_charge.py" скрипт для проведения автоматических платежей.

    # Настройки подключения к серверу эквайринга
    
    TERMINAL_KEY = ''
    TERMINAL_PASS = ''
    

    Где:

    • TERMINAL_KEY - Идентификатор терминала, выдается Продавцу Банком.
    • TERMINAL_PASS - Пароль для терминала, указан в Личном кабинете.

    Сериализуйте изменения

    CentOS 6–7/Debian 8–9

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

    FreeBSD 10/11

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

    Примечание: С подробным описанием процесса регистрации на сайте провайдера электронных платежей «Тинькофф Оплата» и работы с интерфейсами сервиса можно ознакомиться по ссылке.