# Альфа-Банк

Источник: https://docs.emdesell.ru/nastroika-servisa/platezhnye-formy/platezhnye-sistemy/alfabank

В этом разделе инструкции рассмотрим подключение интернет-эквайринга Альфа-Банка к школе. После подключения ученики смогут оплачивать платежные формы картой через Альфа-Банк, а школа — принимать рекуррентные платежи (подписки) и передавать чеки.

## Подготовка в Альфа-Банке

* Зарегистрируйтесь в [Альфа-Банк Интернет-эквайринг](https://alfabank.ru/sme/acquiring/internet/) и подключите услугу **Интернет-эквайринг**
* Для тестовых платежей получите логин и пароль у менеджера банка
* Для настоящих платежей возьмите логин личного кабинета и платежный токен: **Настройки** → **Мерчант** → вкладка **Платёжный токен**. Пароля в боевом кабинете нет, токен его заменяет

![](https://docs.emdesell.ru/.assets/alfabank/01.png)

## Включение в школе

* Перейдите в раздел **Настройки** → вкладка **Платежная система**
* Если еще не включены, включите **Внутрисистемные платежи** и сохраните изменения
* Откройте вкладку **Альфа-Банк**
* В параметре **Платежи через Альфа-Банк** выберите **Включены**
* В поле **Логин** вставьте логин. Логин бывает с префиксом `r-`, `i-` или без него: по префиксу школа сама выбирает нужный адрес шлюза Альфа-Банка, ничего дополнительно указывать не нужно
* В поле **Пароль или токен** вставьте пароль, если включаете **Тестовый режим**, или платежный токен для настоящих платежей. Поле одно: при переходе на настоящие платежи пароль в нем заменяется токеном
* В параметре **Тестовый режим** выберите **Включен**, если сначала хотите проверить оплату на тестовой среде банка, или **Выключен** для приема настоящих платежей
* Выберите **Система Налогообложения (для фискализации)**: **Общая СН**, **Упрощенная СН (доходы)**, **Упрощенная СН (доходы минус расходы)**, **ЕНВД**, **ЕСН**, **Патентная СН** или **Самозанятый**. Список одинаковый во всех платежных системах школы; выберите систему налогообложения, на которой работает ваша организация
* Выберите **Ставка НДС по умолчанию (для позиций чека)**: **Без НДС** или нужную ставку
* Нажмите **Сохранить изменения**

![](https://docs.emdesell.ru/.assets/alfabank/02.png)

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

## Callback-уведомления

Через callback-уведомления Альфа-Банк сообщает школе об оплате, и школа выдает доступы по платежной форме.

* Внизу вкладки **Альфа-Банк** в школе есть блок **Параметры настроек Callback-уведомлений для Альфа-Банка (задаются в ЛК)**. Он не редактируется: это подсказка, что выбрать в личном кабинете банка, и адрес для уведомлений в поле **Ссылка (Result URL)**
* В личном кабинете банка откройте **Настройки** → **Мерчант** → вкладка **Вебхуки** и укажите:
  * **Включить вебхуки** — включено
  * **Тип вебхука** — **Статический**
  * **Метод вебхука** — **GET** или **POST**, школа принимает оба
  * **URL вебхука** — адрес из поля **Ссылка (Result URL)** в школе, вида `https://<адрес вашей школы>/buy_result_alfabank/result`
  * **Тип подписи** — **Симметричный**
  * **Операции** — как минимум **Успешное списание**, **Отмены**, **Платёж отклонён по тайм-ауту** и **Возврат**
* Нажмите **Сгенерировать** у поля **Секрет подписи** и вставьте значение в поле **Callback-токен** в школе. Если токен указан, школа не примет уведомление без верной подписи. Статус оплаты школа в любом случае перепроверяет у банка
* Нажмите **Сохранить** в кабинете банка и сохраните изменения в школе

![](https://docs.emdesell.ru/.assets/alfabank/03.png)

**Важно:** у тестового и боевого кабинетов свои настройки. Тестовый кабинет выглядит так же, только вверху плашка **Тестовая среда**. Настройте вебхуки в том кабинете, через который идут платежи, иначе оплата пройдет, а доступ не выдастся. Если оставить в школе **Callback-токен** от другого кабинета, деньги спишутся, а заказ не завершится.

![](https://docs.emdesell.ru/.assets/alfabank/04.png)

## Чеки

Чеки отправляет банк через онлайн-кассу, подключенную в его личном кабинете. Школа передает банку позиции чека, систему налогообложения и ставку НДС.

* В личном кабинете банка откройте **Настройки** → **Мерчант** → вкладка **Фискализация**
* В поле **Система фискализации** выберите свою онлайн-кассу и заполните поля данными из ее личного кабинета

![](https://docs.emdesell.ru/.assets/alfabank/05.png)

После оплаты в карточке транзакции в личном кабинете банка видно, ушел ли чек: **ОФД статус** — **Доставлено**.

![](https://docs.emdesell.ru/.assets/alfabank/06.png)

## Проверка

* Создайте платежную форму или откройте существующую в разделе [Платежные формы](https://docs.emdesell.ru/nastroika-servisa/platezhnye-formy.md) и выберите в ней Альфа-Банк
* Пройдите оплату по форме. В **Тестовом режиме** используйте тестовые карты из документации, которую Альфа-Банк присылает при подключении

![](https://docs.emdesell.ru/.assets/alfabank/07.png)

* Убедитесь, что заказ в разделе **Заказы** стал оплаченным, а покупатель получил доступ. В личном кабинете банка, в разделе **Транзакции**, у платежа статус **Завершён**

![](https://docs.emdesell.ru/.assets/alfabank/08.png)

* После проверки настройте вебхуки в боевом кабинете, замените в школе пароль на платежный токен, вставьте новый **Callback-токен**, переключите **Тестовый режим** в **Выключен** и сохраните изменения

## Рекуррентные платежи

Альфа-Банк поддерживает рекуррентные платежи: после первой оплаты школа сама списывает деньги по подписке.

* Уточните у менеджера банка, что для вашего кабинета подключены рекуррентные платежи
* Перейдите в раздел **Настройки** → вкладка **Платежная система**
* В параметре **Рекуррентные платежи** выберите **Включены** и нажмите **Сохранить изменения**
* Перейдите в раздел **Платежные формы** → вкладка **Подписки** и нажмите **Создать подписку**
* Укажите название и **Интервал оплаты**, затем нажмите **Сохранить изменения**
