Подключение эквайринга Альфа-Банка

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

Раздел - «Настройки» -> «Приём оплат», он открыт владельцу и совладельцу.

Сначала - подключение в банке

Оставьте заявку на интернет-эквайринг: alfabank.ru. Там же уточняйте тарифы и комиссию - они не наши, и мы на них не влияем.
Дождитесь двух писем от банка. В первом доступы тестовой среды: оплаты там проходят по всем правилам, но денег не двигают. Во втором доступы рабочей среды - по ним ученик и будет платить.
В каждом письме два логина: оператора (им вы входите в личный кабинет эквайринга) и второй, который оканчивается на «-api». Для CRM нужен второй. Логин на «-api» в обоих письмах может совпадать - различаются пароли.
Найдите в письме адрес шлюза - он понадобится при заполнении настроек.

Пароль из письма о тестовой среде подходит сразу, хотя банк иногда включает доступ лишь через несколько часов после письма. Пароль рабочей среды одноразовый: на первой проверке банк ответит «Пользователь должен сменить свой пароль». Тогда войдите платёжным токеном (см. ниже) или попросите поддержку банка выдать новый пароль для логина на «-api».

Включите уведомления об оплате

По уведомлениям банка CRM узнаёт об оплате сразу. В новом магазине они выключены.

В кабинете эквайринга откройте «Настройки», затем «Мерчант» и вкладку «Вебхуки».
Включите переключатель «Включить вебхуки».
«Тип вебхука» - «Динамический».
«Метод вебхука» - любой: CRM принимает и GET, и POST.
Поле «URL вебхука» оставьте пустым. Если там уже стоит адрес вашего сайта, не трогайте его: CRM передаёт свой адрес с каждой оплатой, и уведомления сайта продолжат приходить туда же.
В «Операциях» отметьте «Успешное списание», «Отмены», «Возврат» и «Платёж отклонён по тайм-ауту».
Нажмите «Сохранить».

Адрес для уведомлений Позитив CRM передаёт банку сама вместе с каждой оплатой. Секрет подписи тоже не нужен.

Если вкладки «Вебхуки» в кабинете нет, попросите поддержку банка (acquiring@alfabank.ru) включить уведомления об оплате с динамическим адресом для вашего логина на «-api».

Что попросить у поддержки банка

Напишите в поддержку эквайринга Альфа-Банка на acquiring@alfabank.ru, назовите ИНН и логин на «-api» и попросите:

включить оплату через СБП, если хотите принимать оплату по QR-коду;
подключить онлайн-кассу, если чек должна пробивать касса банка (подробнее - в разделе про кассу ниже);
включить для логина на «-api» версию 3 или новее ответа о статусе заказа (метод getOrderStatusExtended). Без неё банк не сообщает суммы возвратов, и CRM не отличит полный возврат от частичного.

Что заполнить в Позитив CRM

У варианта приёма оплат должен быть выбран способ «Интернет-эквайринг». Дальше:

«Получатель» - имя или название, которое плательщик прочитает в кабинете.
«Через какой сервис» - «Альфа-Банк».
«Адрес шлюза» - тот, что указан в письме банка. Для тестовой среды это «alfa.rbsuat.com (тест)», для рабочей - один из двух адресов на alfabank.ru.
«Вход в API» - «Логин и пароль API» или «Платёжный токен».
«Логин API» - логин на «-api» из письма.
«Пароль API» - пароль из письма или новый, выданный поддержкой банка. Он хранится зашифрованным; сохранённый виден тем же, кому открыт этот раздел, - глазок в поле снимает маску.

Вход платёжным токеном

Основной способ входа - «Логин и пароль API». Платёжный токен выручает, когда банк просит сменить одноразовый пароль рабочей среды: войти им можно сразу, не дожидаясь нового пароля от поддержки.

В кабинете эквайринга откройте «Настройки», затем «Мерчант» и вкладку «Платёжный токен», нажмите «Сгенерировать» и скопируйте платёжный токен.
В Позитив CRM выберите во «Входе в API» вариант «Платёжный токен» и вставьте его в одноимённое поле. Логин при этом не нужен.

Платёжный токен работает только в том магазине, где его сгенерировали: от рабочего магазина на тестовом адресе он не подойдёт. Удалили его в кабинете и сгенерировали новый - прежний перестанет работать: вставьте новый в CRM и снова проверьте доступ.

Полей логина и пароля у нового варианта сначала нет: сохраните вариант со способом «Интернет-эквайринг», и они появятся вместе с кнопками проверки.

Две кнопки проверки, и нужны обе

«Проверить доступ» стоит под полями и отвечает на вопрос, принял ли банк логин и пароль. Оплаты при этом не создаётся. Если доступ не подошёл, ответ банка показывается вам целиком. Пока изменения в полях не сохранены, кнопка не нажимается: проверяется сохранённый доступ. После успеха кнопка становится «Доступ проверен».
«Тестовый платёж» заводит оплату на один рубль и открывает страницу банка, которую увидит ученик. Оплатите рубль до конца.

Вторая кнопка важнее первой: только оплаченный рубль показывает, что банк присылает уведомления и что касса, если она выбрана в поле «Кассовый чек», пробивает чек.

На тестовой среде платите тестовой картой банка: номер 4111 1111 1111 1111, срок 12/34, код 123, код подтверждения 12345678. Денег оплата не двигает.
На рабочей среде рубль списывается по-настоящему, вернуть его можно в кабинете эквайринга.

После оплаты вернитесь во вкладку с CRM: она сама спросит банк, прошла ли оплата. Пока ответа нет, рядом есть кнопка «Проверить оплату». Дальше в блоке будет одно из трёх:

Отметка «Подключено» с датой. Уведомление банка дошло, подключение проверено целиком.
Серая плашка «Тестовая среда Альфа-Банка уведомлений не присылает». Так и должно быть на тестовом адресе: в тестовом кабинете вебхуки не включаются. Тестовый платёж на рабочем адресе проверит и уведомления.
Жёлтая плашка «уведомление от банка до CRM не дошло» на рабочем адресе. Оплата прошла, но вебхуки выключены. Включите их, как описано в разделе Включите уведомления об оплате, и повторите тестовый платёж. Пока уведомлений нет, абонемент после оплаты ученика появляется с опозданием в несколько минут.

Пока оплаты нет, ответ банка появляется строкой рядом с кнопкой. Если там стоит «Банк заблокировал деньги, но не списал их» и через минуту ничего не меняется, магазин принимает оплату в две стадии: попросите поддержку эквайринга перевести его на одностадийную. Иначе оплаты учеников не превратятся в абонементы. Если форму оплаты закрыли или банк отклонил карту, сделайте новый тестовый платёж.

Если под отметкой «Подключено» жёлтая плашка «Альфа-Банк не сообщает суммы возвратов», оплаты работают, но о возвратах CRM узнает без сумм: попросите поддержку банка включить версию 3 ответа о статусе заказа (см. выше) и повторите тестовый платёж. Смена адреса шлюза, логина или пароля обе отметки сбрасывает: проверка на тестовой среде рабочей не засчитывается.

Онлайн-касса

Чек пробивает касса, подключённая через банк: в кабинете эквайринга это раздел «Настройки ОФД». Альфа-Банк работает с АТОЛ, Эвотор, КОМТЕТ, CloudKassir и другими облачными кассами. В CRM выберите в поле «Кассовый чек» вариант «Касса подключена в кабинете эквайринга» и укажите систему налогообложения и ставку НДС.

Вашей кассы в списке банка нет - выберите «Пробиваю чеки сам, в своей кассе». Самозанятому касса не нужна: чек регистрируется в приложении «Мой налог». Подробнее - в статье Онлайн-касса и чеки.

Если оплата прошла, а абонемента нет

Проверьте по порядку:

Подождите несколько минут: без уведомлений CRM узнаёт об оплате, переспросив банк.
Прошёл ли тестовый платёж - есть ли отметка «Подключено».
Совпадает ли адрес шлюза со средой, к которой относится пароль.

Если абонемент не появился и через четверть часа, напишите нам из формы поддержки.

Что дальше

Оплата на странице банка - путь ученика от кнопки до абонемента.
Заявки на оплату - список прошедших оплат и возвраты.