Подключение метода оплаты Альфа-Банк Эквайринг

В данной статье рассмотрим подключение метода оплаты "Альфа-Банк" в интернет-магазине.

• Подключение эквайринга
• Тестирование интеграции
• Перевод в боевой режим
• Настройка уведомлений об оплате (Callback)

Подключение эквайринга

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

Рисунок 1.

Когда ваш запрос на подключение эквайринга будет обработан, на email придут два письма: одно - с тестовыми реквизитами, второе - с реквизитами для работы с действительными платежами. Что с ними делать, описано в последующих пунктах инструкции.

Заметка

Если Вы не получили письма, необходимо написать на почту acquiring@alfabank.ru с запросом продуктивных и тестовых настроек. Обязательно укажите в теме письма ваш ИНН и сайт.

Тестирование интеграции

Сначала рекомендуется настроить оплату с тестовыми данными и провести пробные платежи, чтобы пройти клиентский путь и проверить правильность настройки.

На стороне интернет магазина в административной панели переходим в раздел "Настройки" - "Оплата" (рис. 2).

Рисунок 2.

Далее нажимаем "Добавить способ оплаты". В открывшемся окне указываем любое название метода, выбираем модуль "Альфа-Банк Эквайринг" и добавляем его (рис. 3).

Рисунок 3.

Параллельно открываем письмо с тестовыми доступами, оно выглядит следующим образом (рис. 4):

Рисунок 4.

• Ссылка для входа в Личный Кабинет тестовой среды;
• Логин с суффиксом "-api" – для подключения по программному интерфейсу (API);
• Логин с суффиксом "-operator" – для работы в Личном Кабинете через веб-интерфейс.

Возвращаемся к настройкам метода оплаты в магазине. На скриншоте (рис. 5) показаны и описаны только обязательные к заполнению поля:

Рисунок 5.

Активен - проставляем галочку в данном пункте, чтобы метод оплаты стал доступен на странице оформления заказа.

Налог - если ко всем товарам магазина применяется одна ставка НДС, то в данном пункте выбираем ее. В ином случае оставляем "Использовать налог купленного товара" и задаем его по каждой позиции отдельно.

Шлюз API - из списка требуется выбрать один из шлюзов в тестовом режиме. Как правило, он указывается в письме от банка. Также его можно определить по префиксу или уточнить в поддержке банка.

В поле "Логин" вставляем логин с суффиксом "-api" – для подключения по программному интерфейсу (API).

В поле "Пароль" размещаем пароль для подключения.

Логин дочернего мерчанта должен быть пустым (если Вы не используете агрегаторскую схему).

Передавать данные для печати чека - активируйте настройку, чтобы передавать банку данные для печати чеков в соответствии с 54-ФЗ. При активной настройке также необходимо указать ФФД подключенной кассы.

Система налогообложения - из списка выберите систему налогообложения Вашего юридического лица.
 

Сохраняем настройки, оформляем тестовый заказ в магазине и переходим к оплате. На стороне платежной системы будет доступна тестовая карта, применяем ее и оплачиваем (рис. 6). Код подтверждения операции - 12345678.

Рисунок 6.

После тестового платежа должен произойти переход на страницу успешной оплаты в магазине.
В личном кабинете банка (авторизация по логину с суффиксом "-operator") на вкладке "Транзакции", а также в административной панели магазина в разделе "Заказы" будет проставлен статус оплаты (рис. 7).

Рисунок 7.

Перевод в боевой режим

После успешного проведения тестового платежа, можно приступить к настройке интеграции на продуктивные доступы. Для этого открываем второе письмо с ними (рис. 8)

Рисунок 8.

Необходимо изменить стандартный пароль для логина с суффиксом "-api" на свой, для этого авторизуемся под ним в личном кабинете банка по ссылке из письма, в следующем окне будет предложено изменить пароль (рис. 9).

Рисунок 9.

Затем произойдет возврат на окно авторизации. Снова переходим к настройкам метода оплаты на стороне магазина (рис. 10).

Рисунок 10.

Шлюз API - из списка требуется выбрать один из шлюзов в продуктивном режиме. Как правило, он указывается в письме от банка. Также его можно определить по префиксу или уточнить в поддержке банка.

В поле "Логин" изменяем логин на продуктивный с суффиксом "-api" из письма, если он отличается от тестового.

В поле "Пароль" указываем обновленный пароль для логина с суффиксом "-api".

Ссылка из поля "Уведомление об оплате (Notification URL)" понадобится для следующей настройки синхронизации статуса оплаты от банка к магазину.

Настройка уведомлений об оплате (Callback)

В случае если покупатель после проведения платежа не вернулся в магазин, признак оплаты на платформу не поступит. Для этого необходимо настроить отправку уведомлений от банка к магазину (Callback).

Переходим в личный кабинет банка по ссылке из письма и авторизуемся под доступами с суффиксом "-operator". При первом входе также изменяем пароль (рис. 11).

Рисунок 11.

Далее открываем пункт меню "Настройки" - "Callback уведомления" и нажимаем на переключатель (рис. 12).

Рисунок 12.

После включения уведомлений раскроются настройки (рис. 13):

Рисунок 13.

Тип callback уведомления - указываем "Динамический".

Callback метод - переключаем на "POST".

В поле "Ссылка" вставляем адрес из поля "Уведомление об оплате (Notification URL)" из настроек метода оплаты на стороне магазина (рис. 10).

Операции - выбираем "Успешное списание".
 

Сохраняем, на этом настройка метода оплаты Альфа-Банк в магазине завершена.

Оформите еще один пробный заказ, чтобы проверить, работает ли переход к оплате после перевода в продуктивный режим.