Взаимодействие с платёжной системой «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

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

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

    • Включите возможность проведения платежей:

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

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

      Merchant_ID = 123456
      
      
      
  2. Сериализуйте конфигурационный файл.

    Для CentOS 7–8, Debian 9–11 или RHEL 8:

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

    Техническая строка

    Для FreeBSD 11-13:

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

Скрипт assist.cgi

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

  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 assist.cgi
    

    ``

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

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

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

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

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

    TestMode = 0
    

    ``

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

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

    Для CentOS 7–8, Debian 9–11 или RHEL 8:

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

    Техническая строка

    Для FreeBSD 11-13:

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

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