Подключение модуля "Альфабанк"

Последние изменения: 20.11.2021

Модуль "Альфа-банк" позволяет:

  • создать короткую ссылку на оплату заказа из RetailCRM, чтобы контролировать расходы на отправку смс;

  • отправлять ссылку на оплату в email, смс, мессенджеры;

  • автоматически изменить статус оплаты RetailCRM в случае успешной оплаты заказа (в ручном или автоматическом режиме);

  • сделать частичные возвраты оплат;

  • подключить несколько магазинов из Альфа-банк в 1 аккаунт RetailCRM;

  • оплачивать покупки через СБП.

Для подключения модуля "Альфа-банк" происходит в несколько этапов:

1. Запрос тестовых данных в техническую поддержку "Альфа-банк" по адресу ers@alfabank.ru;

2. Настройка тестовой работы модуля и отправка результатов тестирования в техническую поддержку "Альфа-банк";

3. Получение боевых учетных данных для работы после подтверждения технической поддержкой корректной работы в тестовой среде;

4. Настройка работы модуля в "боевом" режиме.

Последовательность действий описана ниже:

Проверка настроек API ключа

Перейдите в раздел Настройки → Интеграции → Ключи доступа API:

784a208a384f1fc4f306da319e7bf1d9.png

Выберите ключ, который использовали для авторизации в retailcrm.services и проверьте настройки:

  1. Тип доступа. Если загрузка данных будет осуществляться в несколько магазинов, то необходимо выбрать тип доступа "Для всех магазинов".

  2. В блоке "Разрешенные методы API" проставьте все галки для методов групп:

Интеграции 

  • /api/integration-modules/{code}

  • /api/integration-modules/{code}/edit

Оплаты 

  • /api/payment/create-invoice

  • /api/payment/create-invoice/api/payment/(updateInvoice|check)

Справочники

  • /api/reference/sites

Настройка тестовой синхронизации в retailcrm.services

Вы получили логин и пароль от технической поддержки, теперь создаем синхронизацию.

  1. Перейдите в раздел создании настройки синхронизации "Альфа-банк" и нажмите кнопку "Создать новую синхронизацию".

  2. На странице создания синхронизации выберите аккаунт RetailCRM, введите логин и пароль магазина в "Альфа-банк". Для подключения используйте логин для API (из предоставленных данных от поддержки Альфа-банк)

8f431af425e28194760ce84dfdc49221.png
5dd1fc9d6f32480c782c2ad272043fc8.png


  • Способ подтверждения платежа. Доступно ручное или автоматическое подтверждение при работе в заказе RetailCRM;

  • Тип платежа. Для работы с системой быстрых платежей выбирайте "одностадийный", подробнее о работе с СБП описано тут

  • Система налогообложения. Выберите вашу систему налогообложения. Это необходимо для фискализации (отправки информации для печати чеков);

  • Тип подключения. Выберите "Тестовая среда".

29d9483a6ba198bcc7f14daeb977c088.png

Важно! Если используется триггер для отправки смс с ссылкой на оплату клиенту, стандартная ссылка будет отправлена в двух сообщениях.  

Настройка интеграции Альфа-банк в RetailCRM

На стороне RetailCRM необходимо добавить интеграцию модуля для способа оплаты "Альфа-банк", настроить соотвествие статусов оплаты и в настройках способов доставок разрешить оплату.

1. Переходим в настройки вашего аккаунта RetailCRM в раздел "Типы оплат".

2. Создаем новую оплату и выбираем в поле "Интегрировать с" интеграционный модуль.

1c45a8cca4704461cdaf3bfa898630f8.png

3. Нажимаем кнопку настройки статусов счетов и в появившемся окне сопоставляем статусы оплаты счета "Альфа-банк" (левая колонка) и статусы оплат в RetailCRM (правая колонка). При необходимости из этого окна можно добавить сразу новый статус оплаты в RetailCRM.

e51c798ea1643d28198eb109dec6b0ff.png

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

722ccf8dc670b4514ceaf512f95ded65.png


Подключение "боевой" учетной записи "Альфа-банк"

Модуль настроен, и теперь необходимо сформировать ссылку в заказе RetailCRM и выполнить тестовую оплату.

После перехода по ссылке на странице оплаты будут доступны тестовые данные карт для оплаты.

Необходимо сделать 2 тестовых платежа: успешный и не успешный и отправить в поддержку ers@alfabank.ru:

1. скриншоты результатов 2-х оплат;

2. запрос на получения боевых учетных доступов для подключения;

3. webhook для подключения уведомлений в RetailCRM (из настроенной синхронизации retailcrm.services).

91ad2bae19f7ae8b85746621803e3b10.png
ee454283fef83c55c9f01b093c120649.png


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

2bed98bd288db1c684c37719c794a029.png



На этом настройка модуля завершена, теперь можно использовать модуль для работы с заказами!



Работа с несколькими магазинами "Альфа-банк"

В retailcrm.services возможно добавление неограниченного количества аккаунтов "Альфа-банк" для работы в RetailCRM.

Для корректной работы необходимо:

1. Для каждого нового магазина "Альфа-банк" необходимо создать отдельную синхронизацию. Добавляйте новую синхронизацию согласно инструкции

2. Для каждой добавленой синхронизации нужно добавить отдельный тип оплаты для разнесения оплат по нужным магазинам "Альфа-банк". 

3. Переходим в настройки вашего аккаунта RetailCRM в раздел "Типы оплат". При добавлении нового аккаунта или синхронизации, старый тип оплаты в RetailCRM нужно деактивировать и создать заново.

fb7295ebd0540578c67af026777921ab.png

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

520019127691d38cd68be254a48a65a6.png

5. Нажимаем кнопку настройки статусов счетов и в появившемся окне сопоставляем статусы оплаты счета "Альфа-банк" (левая колонка) и статусы оплат в RetailCRM (правая колонка). При необходимости из этого окна можно добавить сразу новый статус оплаты в RetailCRM.

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

Перед началом работы

Созданная ссылка на оплату не имеет ограничений по сроку "жизни". При переходе по ссылке на странице оплаты действует время на ограничение сессии. Это означает, что клиент увидит таймер на оплату - 30 минут. При повторном открытии ссылки, таймер сбросится, и снова вернется к значению 30 минут.

После совершения оплаты статус оплаты автоматически поменяется в RetailCRM на "Оплачен".

Важно: модуль не интегрирован с кассами, данные для формирования чеков передаются в эквайринг; чеки формируются уже на стороне эквайринга.

Частичные возвраты

Частичный возврат средств оформляется через личный кабинет АльфаБанка; в RetailCRM отображается так:

2bc27ecf30d6b7338c2014c71914dfa4.png

Каждый возврат отобразится на странице заказа в RetailCRM в блоке оплат.

Ответы на частозадаваемые вопросы по работе с модулем "АльфаБанк" находятся в разделе Частозадаваемые вопросы. 

Помогла ли вам статья?