Взаимодействие с эквайрингом «СберБанк»

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

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

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

Оставьте заявку на подключение на сайте. Дождитесь, пока сотрудники предоставят вам информацию.

В личном кабинете настройте параметры callback-уведомлений:

  • Тип callback-а: Статический
  • Операции:
    • Успешное списание
    • Отмены
    • Возврат

image

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

Создайте профиль для платёжной системы в АСР LANBilling. Логин и пароль нужно будет указать в скрипте callback-уведомлений.

image

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

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

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

  1. Убедитесь, что установлен PHP 7, а также пакеты perl-cgi и perl-soap-lite.

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

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

    ``

  3. Укажите в файле настройки доступа.

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

    ``

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

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

    ``

  5. Сообщите сотрудникам СберБанка URL-ссылку до скрипта sber_acq.cgi на вашем веб-сервере. Например: https://company.org/cgi-bin/sber_acq.cgi.

  1. Убедитесь, что установлен PHP 7, а также пакеты libsoap-lite-perl, libxml-simple-perl, libcgi-session-perl, libtext-iconv-perl.

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

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

    ``

  3. Укажите в файле настройки доступа.

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

    ``

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

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

    ``

  5. Сообщите сотрудникам СберБанка URL-ссылку до скрипта sber_acq.cgi на вашем веб-сервере. Например: https://company.org/cgi-bin/sber_acq.cgi.

  1. Убедитесь, что установлен PHP 7, а также пакеты p5-IO-SessionData и p5-SOAP-Lite.

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

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

    ``

  3. Укажите в файле настройки доступа.

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

    ``

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

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

    ``

  5. Сообщите сотрудникам СберБанка URL-ссылку до скрипта sber_acq.cgi на вашем веб-сервере. Например: https://company.org/cgi-bin/sber_acq.cgi.

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

Выполните эти шаги, если вы работаете с автоплатежами.

  1. Скопируйте скрипт sber_recurrent_payment.py в директорию /usr/local/billing/pymodules/:

    cp /usr/local/billing/payments/sber_acq/sber_recurrent_payment.py /usr/local/billing/pymodules/

    ``

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

    • Логин и пароль от профиля платёжной системы в АСР LANBilling:

      MANAGER = 'super_pay'
PASSWORD = '12345'

    • ID оператора в биллинге. Если в скрипте задан ненулевой идентификатор OPER_ID, то автоплатежи будут выполняться только по договорам этого оператора:

      OPER_ID = 1

    • Путь доступа к сервису.

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

        SBER_URL ='https://securepayments.sberbank.ru/payment/rest/'

      • Или для тестового режима:

        SBER_URL ='https://3dsec.sberbank.ru/payment/rest/'

    • Логин и пароль для доступа к сервису — их выдают сотрудники СберБанка:

      SBER_USERNAME = '781000013674-20152659-api'
SBER_PASSWORD = 'sberbankNSS'

  3. Перезапустите модуль LBcore.

    systemctl restart lbcore

    ``

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

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

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

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

    ``

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

      [sberbank]
enabled = true

    • Если вы работаете с автоплатежами, укажите ID профиля платёжной системы из АСР LANBilling:

      epsManagerId = 14

    • Если вы не работаете с автоплатежами, отключите их:

      allowAutoPayments = false

    • Укажите путь доступа к сервису.

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

        path = 'https://securepayments.sberbank.ru/payment/rest/'

      • Или для тестового режима:

        path = 'https://3dsec.sberbank.ru/payment/rest/'

    • Введите логин и пароль для доступа к сервису — их выдают сотрудники СберБанка.

      userName = '781000013674-20152659-api'
password = 'sberbankNSS'

    • Дополнительно: валюта, ставка НДС, объект платежа и другие параметры.

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

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

    ``

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

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

    ``

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

      [sberbank]
enabled = true

    • Если вы работаете с автоплатежами, укажите ID профиля платёжной системы из АСР LANBilling:

      epsManagerId = 14

    • Если вы не работаете с автоплатежами, отключите их:

      allowAutoPayments = false

    • Укажите путь доступа к сервису — его выдают сотрудники СберБанка.

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

        path = 'https://securepayments.sberbank.ru/payment/rest/'

      • Или для тестового режима:

        path = 'https://3dsec.sberbank.ru/payment/rest/'

    • Введите логин и пароль для доступа к сервису — их тоже выдают сотрудники СберБанка.

      userName = '781000013674-20152659-api'
password = 'sberbankNSS'

    • Дополнительно: валюта, ставка НДС, объект платежа и другие параметры.

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

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

    ``

Сертификаты НУЦ Минцифры России

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

  1. Создайте каталог:

    mkdir /usr/local/share/ca-certificates/sber/

    ``

  2. Скачайте два сертификата:

    wget https://gu-st.ru/content/lending/russian_trusted_root_ca_pem.crt -O /usr/local/share/ca-certificates/sber/russian_trusted_root_ca_pem.crt
wget https://gu-st.ru/content/lending/russian_trusted_sub_ca_pem.crt -O /usr/local/share/ca-certificates/sber/russian_trusted_sub_ca_pem.crt

    ``

    Подробнее читайте по ссылке.

  3. Обновите хранилище сертификатов:

    update-ca-certificates -v

    ``

    Ответ системы при успешном добавлении:

    2 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d...

    ``

  4. Проверьте, что сертификаты валидны — заверены центром сертификации. Сделать это можно с помощью wget или curl.

    • wget — при проверке ответ не должен быть пустым.

      wget -qS —spider —max-redirect=0 https://3dsec.sberbank.ru/payment/rest/

    • curl — при проверке не должна возвращаться ошибка.

      curl https://3dsec.sberbank.ru/payment/webservices/merchant-ws?wsdl

  1. Убедитесь, что существует каталог /etc/pki/ca-trust/source/anchors/.

  2. Скачайте два сертификата:

    wget https://gu-st.ru/content/lending/russian_trusted_root_ca_pem.crt -O /etc/pki/ca-trust/source/anchors/russian_trusted_root_ca_pem.crt
wget https://gu-st.ru/content/lending/russian_trusted_sub_ca_pem.crt -O /etc/pki/ca-trust/source/anchors/russian_trusted_sub_ca_pem.crt

    ``

    Подробнее читайте по ссылке.

  3. Обновите хранилище сертификатов:

    update-ca-trust force-enable

    ``

    Ответ системы при успешном добавлении:

    2 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d...

    ``

  4. Проверьте, что сертификаты валидны — заверены центром сертификации. Сделать это можно с помощью wget или curl.

    • wget — при проверке ответ не должен быть пустым.

      wget -qS —spider —max-redirect=0 https://3dsec.sberbank.ru/payment/rest/

    • curl — при проверке не должна возвращаться ошибка.

      curl https://3dsec.sberbank.ru/payment/webservices/merchant-ws?wsdl

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

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

Проведите платежи, используя реквизиты тестовых карт. Данные тестовых карт узнайте у сотрудников СберБанка.

В качестве параметра «Cardholder name» нужно использовать не менее двух слов, набранных латинскими буквами. Например, ALEXEY ALEXEEV.

Карты с параметрами «veres=y», «pares=y» или «pares=a» используют технологию «3-D Secure». Для них понадобится код на странице ACS: 12345678.