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

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

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

Личный кабинет ПСБ

  1. Отправьте заявку на эквайринг и заключите договор.

  2. Получите от ПСБ тестовые реквизиты:

    Параметр Пример
    Первая компонента ключа C1C1C1C1C1C1C1C1C1C1C1C1C1
    Вторая компонента ключа A0A0A0A0A0A0A0A0A0A0A0A0A
    TERMINAL — уникальный номер виртуального терминала 79036777
    MERCH_NAME — название торгово-сервисного предприятия TEST_MERCH
    MERCHANT — номер торгово-сервисного предприятия 790367686219999

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

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

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

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

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

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

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

    ``

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

    • IP-адрес и порт для подключения к LBcore.
    • Логин и пароль от профиля платёжной системы в АСР LANBilling.
    • Компоненты секретного ключа.
    # Подключение к LBcore
    HOST = '127.0.0.1'
    PORT = 1502
    MANAGER = 'Login'
    PASSWORD = 'Password'
     
    # Компоненты ключа
    comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
    comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
    

    ``

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

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

    ``

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

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

    ``

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

    • IP-адрес и порт для подключения к LBcore.
    • Логин и пароль от профиля платёжной системы в АСР LANBilling.
    • Компоненты секретного ключа.
    # Подключение к LBcore
    HOST = '127.0.0.1'
    PORT = 1502
    MANAGER = 'Login'
    PASSWORD = 'Password'
     
    # Компоненты ключа
    comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
    comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
    

    ``

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

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

    ``

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

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

    ``

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

    • IP-адрес и порт для подключения к LBcore.
    • Логин и пароль от профиля платёжной системы в АСР LANBilling.
    • Компоненты секретного ключа.
    # Подключение к LBcore
    HOST = '127.0.0.1'
    PORT = 1502
    MANAGER = 'Login'
    PASSWORD = 'Password'
     
    # Компоненты ключа
    comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
    comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
    

    ``

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

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

    ``

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

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

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

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

    ``

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

      enabled = true
      
      
      
    • Укажите ссылку на платёжный шлюз ПСБ.

      • Для промышленной среды:

        url = 'https://3ds.payment.ru/cgi-bin/cgi_link'
        
        
        
      • Или для тестового режима:

        url = 'https://test.3ds.payment.ru/cgi-bin/cgi_link'
        
        
        
    • Введите данные, полученные от ПСБ:

      terminal = '79036777'
      merch_name = 'TEST_MERCH'
      merchant = '790367779999999'
      
      
      
    • Укажите адрес для веб-обращений к вашему файлу psb.py:

      notify_url = 'http://my-operator.ru/cgi-bin/psb.py'
      
      
      
    • Введите значения первой и второй компонент:

      comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
      comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
      
      
      

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

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

    ``

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

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

    ``

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

      enabled = true
      
      
      
    • Укажите ссылку на платёжный шлюз ПСБ.

      • Для промышленной среды:

        url = 'https://3ds.payment.ru/cgi-bin/cgi_link'
        
        
        
      • Или для тестового режима:

        url = 'https://test.3ds.payment.ru/cgi-bin/cgi_link'
        
        
        
    • Введите данные, полученные от ПСБ:

      terminal = '79036777'
      merch_name = 'TEST_MERCH'
      merchant = '790367779999999'
      
      
      
    • Укажите адрес для веб-обращений к вашему файлу psb.py:

      notify_url = 'http://my-operator.ru/cgi-bin/psb.py'
      
      
      
    • Введите значения первой и второй компонент:

      comp1 = 'C1C1C1C1C1C1C1C1C1C1C1C1C1'
      comp2 = 'A0A0A0A0A0A0A0A0A0A0A0A0A'
      
      
      

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

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

    ``

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

Убедитесь, что в конфигурационном файле указан url для тестового режима. Проведите платежи в тестовом режиме.

После успешного тестирования платежей свяжитесь с сотрудниками ПСБ и получите реквизиты для работы в промышленной среде. Не забудьте изменить url в конфигурационном файле — теперь там должна быть указана ссылка для работы в промышленной среде.

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