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

Последние изменения: 04.03.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, в рамках уже зарегистрированного аккаунта "Альфа-банк" необходимо добавить новый магазин. Вебхуки из retailcrm.services нужно добавить только для нового магазина. В случае добавления вебхуков для существующего магазина, который используется для интеграции платежной системы на сайте, у вас перестанут работать уведомления с сайта.

Для добавления нового магазина (сайта) обратитесь в техническую поддержку "Альфа-банк" по адресу ers@alfabank.ru с запросом: "Создайте новые учётные данные (новый магазин) для интеграции модуля "Альфа-банк" и RetailCRM. Также предоставьте тестовые доступы к API и личному кабинету: логин и пароль". В запросе на активацию укажите адрес своего сайта для подключения. В течение суток поддержка пришлет запрошенные данные.

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

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

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

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

8f431af425e28194760ce84dfdc49221.png

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

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

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

29d9483a6ba198bcc7f14daeb977c088.png

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

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

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

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

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

1c45a8cca4704461cdaf3bfa898630f8.png

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

e51c798ea1643d28198eb109dec6b0ff.png

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

722ccf8dc670b4514ceaf512f95ded65.png


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

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

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

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

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 на "Оплачен".

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

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