Альфа-Банк
Интеграция с Альфа-Банком позволяет автоматически менять статус счёта на сайте на «Оплачен» после поступления оплаты через банк.
Подключение состоит из нескольких этапов: сначала необходимо настроить и проверить тестовую интеграцию, затем создать промышленную интеграцию, выпустить TLS-сертификат и API Key, после чего указать полученные данные в административной панели сайта.
1. Настройка тестовой интеграции в Альфа-Банке
Перед созданием рабочей интеграции необходимо пройти тестирование в режиме «Песочница».
Шаг 1. Регистрация
Зарегистрируйтесь и войдите в Портал разработчика Альфа-Банка.

Шаг 2. Переход к настройкам H2H-интеграции
Включите режим «Песочница» с помощью переключателя в верхней части страницы.
Откройте вкладку «Интеграции».
Найдите H2H-интеграцию, нажмите на три точки справа от неё и выберите «Редактировать интеграцию».

Шаг 3. Настройка интеграции
Укажите любое название интеграции.
В поле
Redirect_uriвставьте ссылку, которую можно получить в административной панели сайта: «Настройки → Интеграции → Финансы → Альфа Банк». Откройте интеграцию и скопируйте адрес из строки браузера.В списке сервисов выберите только
transactions.Нажмите «Сохранить».


Шаг 4. Получение тестовых сертификатов
Обратитесь в техническую поддержку Альфа-Банка с просьбой предоставить архив с тестовыми сертификатами. При запросе укажите ИНН юридического лица.
Пароль от архива обычно предоставляется вместе с ответом. Если пароль не указан, уточните его у своего персонального менеджера в Альфа-Банке.

Шаг 5. Выпуск тестового API Key
Вернитесь к тестовой H2H-интеграции.
Нажмите кнопку выпуска API Key.
В поле «Тип IP-запроса» выберите «Статический».
В появившемся поле IP-адреса укажите IP:
45.138.160.19В разделе «Сервисы и продукты банка» выберите
transactions.Сохраните настройки.
В появившемся окне нажмите «Скопировать».
Обязательно сохраните полученный API Key. После закрытия окна посмотреть его повторно будет невозможно — в таком случае потребуется перевыпустить ключ.

2. Проверка тестовой интеграции
После получения тестового API Key необходимо проверить работу интеграции на сайте.
Откройте административную панель сайта.
Перейдите в «Настройки → Интеграции → Финансы → Альфа Банк».
Выберите необходимые реквизиты.
В поле «Токен» вставьте полученный тестовый API Key.
В поле «Сертификат» загрузите файл
baas_swagger_2027.p12из архива с тестовыми сертификатами.Сохраните настройки.
Создайте тестовый заказ с оплатой по счёту и проведите оплату.

Если тестирование прошло успешно, в Портале разработчика Альфа-Банка появится отметка о прохождении пункта «Проверьте тестовую интеграцию».

3. Создание промышленной интеграции
После успешного тестирования можно переходить к настройке рабочей интеграции.
1. В верхней части Портала разработчика переключите режим «Песочница» на «Пром».
2. Откройте вкладку «Интеграции».
3. Нажмите «Создать интеграцию».

4. В качестве типа интеграции выберите «H2H-интеграция» и нажмите «Продолжить».

5. Укажите название интеграции, например «Проставление оплаты по счетам».
6. В поле Redirect_uri вставьте ту же ссылку, которую использовали при настройке тестовой интеграции.

7. В разделе «Сервисы и продукты банка» отметьте transactions.

8. Проверьте введённые данные и нажмите «Создать интеграцию».

В списке интеграций новая интеграция отобразится со статусом «Заблокирована». На этом этапе это нормально.

4. Выпуск промышленного TLS-сертификата
Для работы промышленной интеграции необходимо выпустить TLS-сертификат. В результате этого этапа будут получены файлы, необходимые для создания сертификата формата .pfx.
4.1. Подготовка программ и файлов
Для работы в Windows потребуется программа OpenSSL.
1. Скачайте OpenSSL для своей версии Windows (32- или 64-разрядной системы): Скачать OpenSSL.
2. Достаточно установить версию Light.

3. Скачайте конфигурационный файл openssl_INNLE.cnf из официальной инструкции Альфа-Банка.

4. Создайте на компьютере папку для работы с сертификатами, например D:\cert.
5. Поместите скачанный файл openssl_INNLE.cnf в эту папку.
4.2. Создание закрытого ключа
1. Откройте скачанный OpenSSL.
2. Перейдите в созданную папку командой:
cd /d "D:\cert"
Если вы выбрали другую папку, указав свой путь.
3. Для проверки содержимого папки выполните:
dir
В списке должен присутствовать файл openssl_INNLE.cnf.
4. Создайте закрытый ключ командой:
openssl genrsa -des3 -out Company.key 2048
5. Придумайте пароль и введите его. Затем повторите пароль для подтверждения.
При вводе пароля символы не отображаются на экране — это нормально. Обязательно сохраните пароль, он понадобится на следующих этапах.
После выполнения команды в папке появится файл Company.key.

4.3. Создание запроса на сертификат (CSR)
На основе созданного закрытого ключа необходимо сформировать запрос на сертификат.
Выполните команду:
openssl req -utf8 -config openssl_INNLE.cnf -key Company.key -new -sha256 -out Company.csr
Сначала введите пароль от закрытого ключа Company.key.
Затем OpenSSL запросит данные для сертификата:
Поле | Что указать |
|
|
| Город |
| Название организации или ИП |
| ФИО представителя организации |
| Рабочая электронная почта для уведомлений |
| Оставить пустым для юридических лиц и ИП |
| ИНН юридического лица или ИП |
| Оставить пустым, если не требуется |
| Идентификатор промышленной интеграции |
| Оставить пустым |
| Оставить пустым |
Название города, организации и ФИО можно вводить кириллицей или латиницей.

После заполнения данных будет создан файл Company.csr — запрос на сертификат.

Не закрывайте командную строку: она понадобится на следующих этапах.
4.4. Выпуск и скачивание промышленного сертификата
1. Вернитесь в Портал разработчика Альфа-Банка.
2. Откройте вкладку «TLS-сертификаты».
3. Нажмите «Выпустить сертификат».

4. Укажите рабочую электронную почту. На неё будут приходить уведомления о состоянии сертификата и необходимости его обновления.
5. Выберите созданную промышленную интеграцию.
6. В поле запроса на сертификат (CSR) загрузите файл Company.csr.
7. Нажмите «Выпустить».

8. После выпуска сертификат появится в списке. Скачайте его.

Скачанный сертификат будет иметь имя вида certificate-0000.cer.
Поместите его в рабочую папку D:\cert, где находятся Company.key и Company.csr.
4.5. Подготовка сертификатов удостоверяющего центра
Из архива с сертификатами, который вы получили от Альфа-Банка, скопируйте в рабочую папку два файла:
alfa-bank_st_ca_root.cer— корневой сертификат.alfa-bank_st_ca_sub2.cer— промежуточный сертификат.
В результате в рабочей папке должны обязательно находиться:
Company.key— закрытый ключ.Company.csr— запрос на сертификат.certificate-0000.cer— промышленный сертификат Альфа-Банка.alfa-bank_st_ca_root.cer— корневой сертификат.alfa-bank_st_ca_sub2.cer— промежуточный сертификат.
Для проверки выполните команду:
dir

4.6. Создание PFX-файла
Для установки сертификата в систему необходимо собрать файл формата .pfx.
В командной строке, находясь в рабочей папке, выполните команду:
openssl pkcs12 -export -out Company.pfx -inkey Company.key -in certificate-0000.cer -certfile alfa-bank_st_ca_root.cer -certfile alfa-bank_st_ca_sub2.cer
Вместо certificate-0000.cer укажите фактическое имя скачанного сертификата (серийный номер другой).
OpenSSL запросит пароли:
Enter pass phrase for Company.key— введите пароль, который задавали при создании закрытого ключа.Enter Export Password— введите пароль для создаваемого PFX-файла. Для получения этого пароля обратитесь в техническую поддержку Wow2Print.Verifying - Enter Export Password— повторно введите тот же полученный пароль.

После успешного выполнения команды в папке появится файл Company.pfx.
Именно этот файл потребуется загрузить в настройки интеграции на сайте.

Важно:
Company.key— закрытый ключ. Храните его в безопасном месте и не передавайте третьим лицам.Не удаляйте закрытый ключ: он понадобится при перевыпуске сертификата.
Пароль от PFX-файла сохраните — он может понадобиться при дальнейшей работе с сертификатом.
5. Выпуск промышленного API Key
После получения PFX-файла необходимо выпустить промышленный API Key.
1. В Портале разработчика откройте вкладку «API Keys».
2. Нажмите «Выпустить API Key».

3. В появившемся окне выберите вариант «Внутренний».

4. На следующей странице выберите созданную ранее промышленную интеграцию и нажмите «Продолжить».

5. На втором этапе выберите тип IP-адреса «Статический».
6. Укажите IP-адрес сервера, используемый для подключения к API Альфа-Банка:45.138.160.19
7. В разделе «Сервисы и продукты банка» выберите transactions.
8. Нажмите «Продолжить».

9. Проверьте введённые данные и нажмите «Выпустить ключ».

Обязательно скопируйте и сохраните API Key. После закрытия окна его повторный просмотр будет недоступен.
Готово! Новый API Key появится в списке ключей.

6. Подключение интеграции на сайте ТКС
Теперь все необходимые данные получены. Осталось указать их в административной панели сайта.
Откройте административную панель сайта.
Перейдите в «Настройки → Интеграции → Финансы → Альфа Банк».
Выберите необходимые реквизиты.
В поле «Токен» вставьте полученный промышленный API Key.
В поле «Сертификат» загрузите файл
Company.pfx.Нажмите «Сохранить».

Интеграция настроена!
7. Проверка работы интеграции
Чтобы убедиться, что всё подключено правильно:
Создайте на сайте заказ с оплатой по счёту.
Проведите оплату.
После поступления оплаты проверьте статус оплаты в административной панели сайта.
Если интеграция работает корректно, статус счёта автоматически изменится на «Оплачен».
___________________________________________________________________________
Продление/Перевыпуск TLS-сертификата
Срок действия TLS-сертификата составляет 365 дней.
По истечении срока действия необходимо выпустить новый сертификат. Следите за уведомлениями, которые приходят на электронную почту, указанную при создании CSR.
Для продления сертификата необходимо повторно пройти следующие этапы инструкции:
Создание CSR-запроса — выполните действия из раздела 4.2–4.3. Можно использовать существующий закрытый ключ
Company.keyили создать новый.Выпуск нового сертификата — повторите действия из раздела 4.4, загрузив новый CSR-запрос в Портале разработчика Альфа-Банка.
Создание PFX-файла — повторите действия из раздела 4.5–4.6, используя новый сертификат и соответствующий ему закрытый ключ.
Обновление сертификата на сайте — откройте «Настройки → Интеграции → Финансы → Альфа Банк» и загрузите новый файл
Company.pfx. API Key при этом повторно выпускать не требуется, если настройки интеграции не изменились.
При повторном выпуске сертификата обратите внимание: если используется новый закрытый ключ, его необходимо учитывать при создании нового PFX-файла.