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

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

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

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

  1. Заполните заявку на регистрацию.

  2. Получите от Assist профиль для тестового подключения. Он будет содержать данные:

    Параметр Пример
    Merchant_ID — уникальный идентификатор вашего предприятия 123456
    Логин администратора личного кабинета — название вашей организации login-admin
    Логин пользователя для работы с личным кабинетом и веб-сервисами login-user
    Пароль пользователя для работы с личным кабинетом и веб-сервисами password-user
    URL личного кабинета https://account.demo.paysecure.ru

    Более подробно о тестовом подключении можно узнать в документации Assist.

  3. Задайте настройки в личном кабинете.

    • Перейдите в личный кабинет по URL, который прислал Assist.

    • Авторизуйтесь, используя логин администратора.

    • Перейдите в раздел «Настройки мерчантов» и кликните «Настройки отправки результатов платежей».

    • Введите URL — адрес на вашем веб-сервере, куда Assist будет отправлять уведомления о платежах.

      image
    • Укажите тип протокола и тип подписи.

    • Нажмите «Сохранить».

      image

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

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

Скрипт assist.cgi

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

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

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

    ``

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

    • Метод подключения к LBcore. По умолчанию — http; если настроена работа API по SSL — https.
    • IP-адрес для подключения к LBcore.
    • Логин и пароль от профиля платёжной системы в АСР LANBilling.
    • Секретное слово для проверки алгоритма хеширования MD5.
    # Атрибуты для доступа к LBcore
    my $proto = 'https';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'login';
    my $manager_pass = 'password';
    my $md5_key = 'secret';
    

    ``

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

    chmod +x /var/www/cgi-bin/assist.cgi
    

    ``

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

    cp /usr/local/billing/payments/assist/assist.cgi /usr/lib/cgi-bin/
    

    ``

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

    • Метод подключения к LBcore. По умолчанию — http; если настроена работа API по SSL — https.
    • IP-адрес для подключения к LBcore.
    • Логин и пароль от профиля платёжной системы в АСР LANBilling.
    • Секретное слово для проверки алгоритма хеширования MD5.
    # Атрибуты для доступа к LBcore
    my $proto = 'https';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'login';
    my $manager_pass = 'password';
    my $md5_key = 'secret';
    

    ``

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

    chmod +x /usr/lib/cgi-bin/assist.cgi
    

    ``

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

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

    ``

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

    • Метод подключения к LBcore. По умолчанию — http; если настроена работа API по SSL — https.
    • IP-адрес для подключения к LBcore.
    • Логин и пароль от профиля платёжной системы в АСР LANBilling.
    • Секретное слово для проверки алгоритма хеширования MD5.
    # Атрибуты для доступа к LBcore
    my $proto = 'https';
    my $lbcore_host = '127.0.0.1';
    my $manager_login = 'login';
    my $manager_pass = 'password';
    my $md5_key = 'secret';
    

    ``

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

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

    ``

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

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

  1. Внесите изменения в файл конфигурации assist.ini:

    nano /etc/lanbilling/phpclient/client/assist.ini
    

    ``

    • Включите платёжную систему в личном кабинете абонентов АСР LANBilling.

      enabled = true
      
      
      
    • Введите логин и пароль пользователя для работы в личном кабинете Assist:

      Login = 'login-user'
      Password = 'password-user'
      
      
      
    • Укажите свой Merchant ID:

      Merchant_ID = 123456
      
      
      

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

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

    ``

  1. Внесите изменения в файл конфигурации assist.ini:

    nano /usr/local/etc/lanbilling/phpclient/client/assist.ini
    

    ``

    • Включите платёжную систему в личном кабинете абонентов АСР LANBilling.

      enabled = true
      
      
      
    • Введите логин и пароль пользователя для работы в личном кабинете Assist:

      Login = 'login-user'
      Password = 'password-user'
      
      
      
    • Укажите свой Merchant ID:

      Merchant_ID = 123456
      
      
      

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

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

    ``

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

  1. Проведите платежи в тестовом режиме работы предприятия.

  2. Заключите договоры с расчётным банком и с компанией Assist.

  3. Получите от Assist URL для рабочего режима.

  4. Отключите тестовый режим в конфигурационном файле assist.ini:

    TestMode = 0
    

    ``

  5. В этом же файле укажите URL для рабочего режима:

    • merchant_url — адрес запроса на создание платежа.
    • confirm_url — адрес для подтверждения платежа, если используется двустадийная оплата.
    • orderresult_url — адрес для получения результата оплаты.
  6. Сериализуйте конфигурационный файл.

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