Подключение метода оплаты Альфа-Банк Эквайринг
База знаний постепенно обновляется, поэтому некоторые материалы могут временно отличаться от интерфейса вашей панели администрирования.
В данной статье рассмотрим подключение метода оплаты "Альфа-Банк" в интернет-магазине.
- Подключение эквайринга
- Тестирование интеграции
- Перевод в боевой режим
- Настройка уведомлений об оплате (Callback)
Подключение эквайринга
Если договор с платежной системой еще не заключен, можете оставить заявку на сайте Альфа-Банка (рис. 1) по данной ссылке.
Рисунок 1.
Когда ваш запрос на подключение эквайринга будет обработан, на email придут два письма: одно - с тестовыми реквизитами, второе - с реквизитами для работы с действительными платежами. Что с ними делать, описано в последующих пунктах инструкции.
Заметка
Если Вы не получили письма, необходимо написать на почту acquiring@alfabank.ru с запросом продуктивных и тестовых настроек. Обязательно укажите в теме письма ваш ИНН и сайт.
Тестирование интеграции
Сначала рекомендуется настроить оплату с тестовыми данными и провести пробные платежи, чтобы пройти клиентский путь и проверить правильность настройки.
На стороне интернет магазина в административной панели переходим в раздел "Настройки" - "Оплата" (рис. 2).
Рисунок 2.
Далее нажимаем "Добавить способ оплаты". В открывшемся окне указываем любое название метода, выбираем модуль "Альфа-Банк Эквайринг" и добавляем его (рис. 3).
Рисунок 3.
Рисунок 4.
Рисунок 5.
Параллельно открываем письмо с тестовыми доступами, оно выглядит примерно следующим образом (рис. 6):
Рисунок 6.
- Ссылка для входа в Личный Кабинет тестовой среды;
- Логин с суффиксом "-api" – для подключения по программному интерфейсу (API);
- Логин с суффиксом "-operator" – для работы в Личном Кабинете через веб-интерфейс.
Возвращаемся к настройкам метода оплаты в магазине. На скриншоте (рис. 7) показаны и описаны только обязательные к заполнению поля:
Рисунок 7.
Активен - проставляем галочку в данном пункте, чтобы метод оплаты стал доступен на странице оформления заказа.
Налог - если ко всем товарам магазина применяется одна ставка НДС, то в данном пункте выбираем ее. В ином случае оставляем "Использовать налог купленного товара" и задаем его по каждой позиции отдельно.
Шлюз API - из списка требуется выбрать один из шлюзов в тестовом режиме. Как правило, он указывается в письме от банка. Также его можно определить по префиксу или уточнить в поддержке банка.
В поле "Логин" вставляем логин с суффиксом "-api" – для подключения по программному интерфейсу (API).
В поле "Пароль" размещаем пароль для подключения.
Логин дочернего мерчанта должен быть пустым (если Вы не используете агрегаторскую схему).
Передавать данные для печати чека - активируйте настройку, чтобы передавать банку данные для печати чеков в соответствии с 54-ФЗ. При активной настройке также необходимо указать ФФД подключенной кассы.
Система налогообложения - из списка выберите систему налогообложения Вашего юридического лица.
Сохраняем настройки, оформляем тестовый заказ в магазине и переходим к оплате. На стороне платежной системы будет доступна тестовая карта, применяем ее и оплачиваем (рис. 8). Код подтверждения операции - 12345678.
Рисунок 8.
После тестового платежа должен произойти переход на страницу успешной оплаты в магазине.
В личном кабинете банка (авторизация по логину с суффиксом "-operator") на вкладке "Транзакции", а также в административной панели магазина в разделе "Заказы" будет проставлен статус оплаты (рис. 9).
Рисунок 9.
Перевод в боевой режим
После успешного проведения тестового платежа, можно приступить к настройке интеграции на продуктивные доступы. Для этого открываем второе письмо с ними (рис. 10)
Рисунок 10.
Необходимо изменить стандартный пароль для логина с суффиксом "-api" на свой, для этого авторизуемся под ним в личном кабинете банка по ссылке из письма, в следующем окне будет предложено изменить пароль (рис. 11).
Рисунок 11.
Затем произойдет возврат на окно авторизации. Снова переходим к настройкам метода оплаты на стороне магазина (рис. 12).
Рисунок 12.
Шлюз API - из списка требуется выбрать один из шлюзов в продуктивном режиме. Как правило, он указывается в письме от банка. Также его можно определить по префиксу или уточнить в поддержке банка.
В поле "Логин" изменяем логин на продуктивный с суффиксом "-api" из письма, если он отличается от тестового.
В поле "Пароль" указываем обновленный пароль для логина с суффиксом "-api".
Ссылка из поля "Уведомление об оплате (Notification URL)" понадобится для следующей настройки синхронизации статуса оплаты от банка к магазину.
Настройка уведомлений об оплате (Callback)
В случае если покупатель после проведения платежа не вернулся в магазин, признак оплаты на платформу не поступит. Для этого необходимо настроить отправку уведомлений от банка к магазину (Callback).
Переходим в личный кабинет банка по ссылке из письма и авторизуемся под доступами с суффиксом "-operator". При первом входе также изменяем пароль (рис. 13).
Рисунок 13.
Далее открываем пункт меню "Настройки" - "Мерчант" - вкладка "Вебхуки" и нажимаем на переключатель "Включить вебхуки". После включения уведомлений раскроются настройки (рис. 14).
Рисунок 14.
Тип вебхука - указываем "Динамический".
Метод вебхука - переключаем на "POST".
В поле "URL вебхука" вставляем адрес из поля "Уведомление об оплате (Notification URL)" из настроек метода оплаты на стороне магазина (рис. 12).
Тип подписи - выбираем "Симметричный".
Операции - выбираем "Успешное списание".
Сохраняем, на этом настройка метода оплаты Альфа-Банк в магазине завершена.
Оформите еще один пробный заказ, чтобы проверить, работает ли переход к оплате после перевода в продуктивный режим.