Подключение Альфа-Банка через Alfa API

Альфа отдаёт выписку по Alfa API сама, без кодов и подтверждений. Доступ вы выпускаете самостоятельно: вход в ваш Альфа-Бизнес нам не нужен, пароли ваши мы не видим ни на одном шаге. Повозиться придётся, потому что банк требует сертификат. Самую неприятную часть свóдно берёт на себя.

Что понадобится

• Доступ в Альфа-Бизнес с правами администратора. Или человек с такими правами рядом с вами.
• Номера расчётных счетов, которые вы хотите вести в свóдно. Можно не все.
• ИНН и полное наименование юрлица как в учредительных документах. Они уйдут в сертификат, поэтому сверьте буквы.
• Сотрудник, ответственный за интеграцию. Ключ доступа будет работать от его имени и проживёт ровно столько, сколько живут его права в банке. Бухгалтер, финансовый директор или руководитель подойдут. Человек, который через неделю уволится, подойдёт плохо.
• Около часа вашего времени плюс день или два на обработку в банке.

Кто что делает

Доступ выпускаете вы, в своём кабинете. Закрытый ключ от сертификата при этом никуда из свóдно не уходит.

Вы: подписываете договор, выдаёте права сотруднику, создаёте интеграцию, передаёте банку наш запрос на сертификат и выпускаете ключ доступа.

свóдно: генерирует закрытый ключ и запрос на сертификат, проверяет присланный банком файл и после подключения забирает выписку по умолчанию каждые шесть часов.

Банк: подписывает договор, присылает тестовые доступы, выпускает сертификат.

Отдельно про терминал. В собственной инструкции Альфа предлагает сгенерировать ключ и запрос на сертификат командами OpenSSL. Вам этого делать не придётся: свóдно выпускает их у себя, вы просто скачиваете готовый файл.

Порядок шагов менять нельзя

Выпустить ключ доступа хочется сразу, вместе с client_id. Так не выйдет. Пока сертификат не выпущен, банк держит интеграцию заблокированной и на раннюю попытку отвечает отказом без внятной причины.

Статус интеграции меняется по цепочке: «Заблокирована» → сертификат → «Новая» → ключ доступа → «Активна».

Шаг 1. Подпишите договор на Alfa API

Alfa API подключается по отдельному договору на информационно-технологическое взаимодействие. Денег он не стоит, но без него Портал разработчика не откроется.

1. Войдите в Альфа-Бизнес и откройте «Все продукты и сервисы».
2. Найдите плитку Alfa API и нажмите «Подключить Alfa API».
3. Выберите организацию, прочитайте текст договора, нажмите «Подписать».
4. Подтвердите кодом из СМС.

Подписанный договор потом виден в разделе «Настройки», пункт «Управление согласиями», карточка Alfa API.

Если плитки нет или подключение не проходит, напишите своему менеджеру или на alfa_api@alfabank.ru. Формулируйте прямо: нужен доступ к Alfa API для получения выписок по счетам, схема H2H. Слово «H2H» лучше произнести сразу, оно отсекает половину уточняющих вопросов.

Шаг 2. Проверьте права сотрудника

Откройте карточку сотрудника, от чьего имени будет работать интеграция. У него должно быть право смотреть выписку по нужным счетам и доступ к Alfa API.

Проверьте это сейчас. На пятом шаге разбираться будет дороже: сотруднику без прав на выписку банк ключ не выпустит, но откажет невнятно, и причину придётся угадывать.

Шаг 3. Создайте интеграцию в Портале разработчика

После договора банк пришлёт письмо с тестовыми доступами: тестовый ключ и архив с тестовым сертификатом, пароль от архива в том же письме. В мастере свóдно есть отдельная проверка по тестовому ключу. Сейчас она также требует уже загруженный сертификат, хотя загрузка стоит следующим шагом.

Из-за этого пройти песочницу в текущем порядке не получится: проверка остановится с сообщением «Сначала загрузите сертификат банка». Это ограничение мастера, а не ошибка тестового ключа.

1. Переключитесь в рабочую среду «Пром». Переключатель в правом верхнем углу портала.
2. Если вы работаете в режиме группы компаний, сначала зайдите в профиль и выберите юрлицо, для которого делаете интеграцию.
3. Нажмите «Создать интеграцию», тип H2H.
4. Укажите название и redirect_uri. Для H2H подойдёт http://localhost.ru, поле здесь формальное.
5. В сервисах отметьте выписки по счетам и профиль организации.
6. Скопируйте client_id и впишите его в свóдно.

Сразу после создания интеграция числится в статусе «Заблокирована». Так и должно быть, разблокирует её сертификат на следующем шаге.

Промышленных интеграций у вас может быть не больше пяти.

Шаг 4. Получите сертификат

Сертификат нужен банку, чтобы доверять запросам, которые приходят от вашего имени. Закрытый ключ и запрос на сертификат свóдно выпускает у себя, устанавливать и настраивать вам ничего не нужно.

1. В свóдно откройте «Настройки», раздел «Интеграции», карточку «Альфа-Банк».
2. Впишите наименование организации, ФИО и почту ответственного сотрудника, нажмите «Сгенерировать запрос на сертификат» и скачайте файл.
3. Передайте файл банку. Либо через Портал разработчика в разделе «TLS-сертификаты», либо письмом на alfa_api@alfabank.ru с темой «Запрос на сертификат». Для письма переименуйте файл по названию организации латиницей.
4. Присланный банком файл .cer загрузите в том же окне свóдно.

Закрытый ключ не покидает свóдно, и передавать третьим лицам нечего. Банк предупреждает о том же: никому не отдавайте закрытый ключ. Если его у вас просят, насторожитесь. Банку он не нужен, ему хватает запроса.

Шаг 5. Выпустите ключ доступа

Сертификат загружен, интеграция разблокирована. Осталось её активировать.

В карточке H2H-интеграции нажмите «Выпустить ключ» и заполните два параметра.

• IP-адреса: 91.218.112.145
• Сервисы: transactions и customer

Запросы с других адресов банк просто не пропустит. На один ключ разрешено до двадцати адресов, так что наш добавится к вашим прежним и ничего не вытеснит.

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

Что произойдёт дальше

Выписка загружается по расписанию, подтверждать ничего не нужно. Операции появятся в разделе «Операции», остаток в виджете «Остатки ДС».

Проверить связь в любой момент можно кнопкой «Проверить» в списке интеграций.

Что будет через месяц и через год

Месяц тишины отзывает ключ. Если по интеграции тридцать дней не было ни одного запроса, банк отзывает ключ автоматически. При включённом расписании свóдно обращается за выпиской каждые шесть часов. После долгой паузы ключ придётся выпустить заново.

Срок сертификата указан в файле банка. Сразу после загрузки свóдно покажет дату окончания и число оставшихся дней. Отдельного напоминания пока нет, поэтому поставьте его в календарь. Продление проходит так же, как первый выпуск.

Интеграцию держит один сотрудник. Ключ работает от имени того, кто его выпустил. Уволится этот человек или потеряет права в банке, и выписка перестанет приходить. Тогда шаги со второго по пятый нужно повторить от имени другого сотрудника.

Если что-то пошло не так

Банк отказал при выпуске ключа: чаще всего у сотрудника нет прав на выписку либо ещё не выпущен сертификат. Проверьте статус интеграции, он должен быть «Новая».

Интеграция так и висит в статусе «Заблокирована»: сертификат банк ещё не выпустил или файл .cer не загружен в свóдно.

Выписка перестала приходить: первым делом посмотрите, работает ли в банке сотрудник, от чьего имени выпущен ключ, и не истёк ли годовой срок сертификата.

Связь была и пропала после переезда офиса: белый список IP тут ни при чём. В нём стоит наш адрес, ваш собственный банк не проверяет. Ищите причину в правах сотрудника.

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