Примеры интеграции с банками ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Настройка Альфа Банк (токен) ============================ Взаимодействие с платежным шлюзом Банка осуществляется через сеть Интернет по протоколу HTTP с использованием клиентских самоподписанных сертификатов RSA/TLS. Указанный сертификат используется для подписи запросов. Чтобы получить сертификат для подписи запросов, клиент самостоятельно генерирует ключевую пару (client.crt и client.key): - client.crt – сертификат, который клиент передает в Банк по адресу acquiring@alfabank.ru для регистрации на ПШ Банка; - client.key – приватный ключ, который клиент оставляет у себя (в Банк не передает) и использует для подписи тела запроса. Установка OpenSSL и создание сертификата на Windows --------------------------------------------------- 1. Перейдите на страницу загрузки OpenSSL, скачайте необходимый инсталлятор версии Light в зависимости от разрядности ОС и запустите его. https://slproweb.com/products/Win32OpenSSL.html 2. После установки программы, необходимо добавить путь к ней как системную переменную. Для этого перейдите в Панель управления → Система → Дополнительные параметры системы → Переменные среды. .. figure:: ../manager/picture/image1.png :scale: 60 % :align: center В разделе Системные переменные выберите переменную Path и нажмите Изменить. В открывшемся окне нажмите Создать и введите путь к папке bin установленного приложения (C:\Program Files\OpenSSL-Win64\bin по умолчанию). Нажмите ОК. .. hint:: Для применения настроек может понадобиться перезагрузка компьютера. 3. Создайте папку, куда вы бы хотели сохранить созданные сертификаты (например, C:\cert). 4. Откройте командную строку (cmd) от имени администратора и перейдите в ранее созданную папку (cd /d C:\cert). 5. Выполните следующую команду: ``openssl req -x509 -newkey rsa:4096 -keyout private.key -out client.crt -nodes -days 3650`` где: - x509 — уточнение, что нам нужен именно самоподписанный сертификат; - newkey — автоматическое создание ключа сертификата; - days — срок действия сертификата в днях; - keyout — путь (если указан) и имя файла ключа; - out — путь (если указан) и имя файла сертификата. Последовательно введите: код страны, её название, город, название компании, ваше имя и адрес электронной почты. .. figure:: ../manager/picture/image3.png :scale: 60 % :align: center В папке C:\cеrt сгенерируются 2 файла: - certificate.crt — сам сертификат; - privateKey.key — файл ключа. Ключевая пара генерируется сроком на 10 лет (3650 дней). .. note:: Файлу certificate.crt присвойте имя, идентифицирующее клиента банка (client.crt). Регистрация в Альфа Банке ------------------------- Чтобы получить сертификат для подписи запросов необходимо по адресу acquiring@alfabank.ru направить письмо с указанием: 1. ИНН, наименование Организации, на которую регистрируется сертификат; 2. Сертификат регистрируется первично или повторно; 3. Тип среды, для которой выпускается сертификат: тестовая или промышленная. 4. Файл client.crt – сертификат, который клиент передает в Банк. После регистрации сертификата, Банк передает Клиенту: 1. Аlias - имя зарегистрированного сертификата, которое будет использоваться в «key-name»; 2. TermNo – «Уникальный идентификатор терминала». 3. Клиентский сертификат RSA/TLS для поднятия MTLS соединения (двухсторонней аутентификации). 4. Для проведения тестирования клиенту доступен тестовый стенд. Адрес тестовой среды (маршрут отправки) - http://217.12.103.147:9914/fsCryptoProxy Для перехода на продуктивную среду клиенту необходимо заключить сделку по СБП с Альфа-Банком, после чего запросить боевые доступы. Адрес боевой среды - https://217.12.103.146:443/fsCryptoProxy Настройка СБП терминала ----------------------- Перейдите в меню Настройки в раздел Агент ТСП. Выберите Агент ТСП Льфа Банк (токен). Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image2.png :scale: 60 % :align: center Настройка Альфа Банк (логин) ============================ Данный способ подключения доступен по договору Интернет-эквайринга клиентам Альфа Банка. Для получения параметров подключения необходимо: 1. Зайти в свой личный кабинет Интернет-банка. 2. Оставить заявку на Интернет-эквайринг. 3. Заполнить данный о своей торговой точке. 4. Заключить договор на Интернет-эквайринг и СБП. 5. Получить от банка: * Доступ в личный кабинет платежной системы https://pay.alfabank.ru/lk/; * Адрес платежного шлюза; * Логины доступа к личному кабинету с окончанием -operator и доступа по API с окончанием -api; * Пароль (первичный пароль необходимо изменить на собственный при первом входе в личный кабинет). .. note:: Для смены пароля необходимо войти в Личный Кабинет, используя присланные логин и пароль. Система предложит сменить пароль. Создайте новый пароль руководствуясь правилами: - количество символов – не менее 8; - должен содержать латинские символы в нижнем и верхнем регистре, цифры, и символы из группы: ``! " № ; : ? * ( ) + = /\ < > , . {}`` .. important:: Данную операцию потребуется сделать как для логина с окончанием -api, так и для логина с окончанием -operator. Взаимодействие с платежным шлюзом Банка осуществляется через сеть Интернет по протоколу HTTPS с использованием логина и пароля. Настройка СБП терминала ----------------------- Перейдите в меню Настройки в раздел Агент ТСП. Выберите Агент ТСП Льфа Банк (логин). Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image12.png :scale: 60 % :align: center .. attention:: Обратите внимание на адрес платежного шлюза, предоставленный банком, и правильно его заполните в поле baseUrl. Возможные варианты: * https://payment.alfabank.ru/payment/ * https://pay.alfabank.ru/payment/ Настройка ЮКасса ================ Для настройки параметров авторизации перейдите в пункт меню «Агент ТСП» в настройках. .. figure:: ../manager/picture/image-3.png :scale: 60 % :align: center Выберите "ЮКасса" из выпадающего меню «Агент ТСП». .. attention:: Для получения параметров соединения с банком необходимо предварительно `заключить с ним договор о работе с СБП `_ Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image_2024-06-27_17-23-26.png :scale: 60 % :align: center Нажмите кнопку "Сохранить". .. figure:: ../manager/picture/image_2024-06-27_17-22-19.png :scale: 60 % :align: center .. hint:: Если Вы никогда раньше не работали с СБП и у Вас нет необходимых параметров подключения к банку, то свяжитесь с нами. Сотрудники компании MERTECH проконсультируют Вас и помогут пройти необходимые процедуры. Настройка ЦФТ ============= Для настройки параметров авторизации перейдите в пункт меню «Агент ТСП» в настройках. .. figure:: ../manager/picture/image-3.png :scale: 60 % :align: center Выберите "ЦФТ" из выпадающего меню «Агент ТСП». .. attention:: Для получения параметров соединения с банком необходимо предварительно заключить с ним договор о работе с СБП. Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image_2024-06-27_18-32-20.png :scale: 60 % :align: center Нажмите кнопку "Сохранить". .. figure:: ../manager/picture/image_2024-06-27_18-28-03.png :scale: 60 % :align: center .. hint:: Если Вы никогда раньше не работали с СБП и у Вас нет необходимых параметров подключения к банку, то свяжитесь с нами. Сотрудники компании MERTECH проконсультируют Вас и помогут пройти необходимые процедуры. Настройка Газпромбанк ===================== Для настройки параметров авторизации перейдите в пункт меню «Агент ТСП» в настройках. .. figure:: ../manager/picture/image-3.png :scale: 60 % :align: center Выберите "Газпромбанк" из выпадающего меню «Агент ТСП». .. attention:: Для получения параметров соединения с банком необходимо предварительно заключить с ним договор о работе с СБП. Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image_2024-06-27_18-30-49.png :scale: 60 % :align: center Нажмите кнопку "Сохранить". .. figure:: ../manager/picture/image_2024-06-27_18-28-19.png :scale: 60 % :align: center .. hint:: Если Вы никогда раньше не работали с СБП и у Вас нет необходимых параметров подключения к банку, то свяжитесь с нами. Сотрудники компании MERTECH проконсультируют Вас и помогут пройти необходимые процедуры. Настройка Тинькофф банк ======================= Для настройки параметров авторизации перейдите в пункт меню «Агент ТСП» в настройках. .. figure:: ../manager/picture/image-3.png :scale: 60 % :align: center Выберите "Тинькофф банк" из выпадающего меню «Агент ТСП». .. attention:: Для получения параметров соединения с банком необходимо предварительно заключить с ним договор о работе с СБП. Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image_2024-06-27_18-29-44.png :scale: 60 % :align: center Нажмите кнопку "Сохранить". .. figure:: ../manager/picture/image_2024-06-27_18-29-59.png :scale: 60 % :align: center .. hint:: Если Вы никогда раньше не работали с СБП и у Вас нет необходимых параметров подключения к банку, то свяжитесь с нами. Сотрудники компании MERTECH проконсультируют Вас и помогут пройти необходимые процедуры. Настройка Райффайзенбанк ======================== Для настройки параметров авторизации перейдите в пункт меню «Агент ТСП» в настройках. .. figure:: ../manager/picture/image-3.png :scale: 60 % :align: center Выберите "Райффайзенбанк" из выпадающего меню «Агент ТСП». .. attention:: Для получения параметров соединения с банком необходимо предварительно заключить с ним договор о работе с СБП. Заполните поля в форме по аналогии как представлено на рисунке ниже. .. figure:: ../manager/picture/image_2024-06-27_18-31-34.png :scale: 60 % :align: center Нажмите кнопку "Сохранить". .. figure:: ../manager/picture/image_2024-06-27_18-28-36.png :scale: 60 % :align: center .. hint:: Если Вы никогда раньше не работали с СБП и у Вас нет необходимых параметров подключения к банку, то свяжитесь с нами. Сотрудники компании MERTECH проконсультируют Вас и помогут пройти необходимые процедуры.