Инструкция по интеграции МойСклад и МодульБанк

• В аккаунте МойСклад необходимо перейти в раздел «Приложения» → категория «Платежные системы» → «МодульБанк». Для быстрого перехода к установке приложения нажмите кнопку Установить

  

• В карточке приложения нажмите кнопку «Установить».

  

• После установки приложения переходим к настройке. Для этого нажмите кнопку «Перейти в приложение».

  

Настройка приложения

• После установки приложения открывается раздел настроек «МодульБанк». Заполните его данными из личного кабинета банка. Вам потребуется идентификатор магазина, Тестовый и Рабочий секретные ключи (Рабочий доступен только после прохождения тестирования).

  

Получение ключей интеграции

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

  

• Выбираем пункт меню Еще → Интернет-эквайринг.

  

• Открывается вкладка настроек Интернет-эквайринг. Нажимаем кнопку Интеграция.
  

  

• Далее откроется способ интеграции, нажимаем на панель Подключение через API.

  

• Нам открываются настройки API. Из блока Параметры подключения копируем Идентификатор магазина и Тестовый секретный ключ и переносим настройки в приложение.
  

  

• После завершения настройки, вы увидите данное сообщение. На этом интеграция магазина завершена.

  

Работа с виджетом

• После завершения интеграции станет доступным встроенный виджет в разделы «Счета покупателям» и «Заказы покупателей». С помощью данного виджета, вы сможете создать ссылку на оплату для вашего клиента. Нажмите кнопку «Создать ссылку на оплату».

  

• После создания ссылки на оплату, приложение запишет ссылку в дополнительное поле. Так же, ссылка будет доступна для копирования до перехода транзакции в статус Оплачено.

  

• После создания ссылки на оплату, вы можете скопировать ее и отправить ее клиенту любым удобным способом. Например: сделайте клик в поле виджета с заполненной ссылкой на оплату. Приложение сразу же скопирует ссылку в буфер обмена и оповестит вас об этом.

  

• Виджет поддерживает функционал возврата оплаты, для этого необходимо нажать кнопку «Возврат оплаты».

  

• После нажатия на кнопку «Возврат оплаты» приложение попросит вас подтвердить данную операцию. Данный функционал сделан в качестве защиты от случайного клика. Таким образом, вы не сможете ошибочно сделать возврат.

  

• После нажатия на кнопку «Возврат оплаты» будет отправлен запрос в банк на совершение операции. Результат будет отображаться в виджете. После совершения операции возврата у счета или заказа будет присвоен статус Возврат.

  

Самостоятельное тестирование оплаты

•  Для проведения тестов добавим новый заказ и создадим ссылку на оплату.
  

  

• В нашем случае, для тестирование ссылки на оплату, мы воспользуемся ссылкой, которую создали ранее при описании функционала виджета. Кликните по ссылке для перехода к оплате.
  

  

• Перед нами пример формы оплаты МодульБанк.

  

• Для проведения тестового платежа воспользуемся тестовой картой. Для этого нажимаем кнопку Заполнить тестовой картой, как это показано на изображении ниже. Далее нажимаем кнопку Оплатить

  

• Пример успешной оплаты заказа.

  

• В заказе или сделке, будет присвоен статус Оплачено, так же приложение добавит Входящий платеж.

  

Настройка действий сценария

•  Для автоматического создания ссылки на оплату, требуется произвести настройку «Сценария».
  
  Приложение поддерживает 2 вида объектов МойСклад:
  1) Заказ покупателя
  2) Счет покупателю
  
  Для создания первого сценария, в правом верхнем углу МойСклад, нажмите на ваш профиль, далее откроется выпадающее меню. Нажмите «Настройки».
  

• 

• В левом боковом меню перейдите в раздел «Сценарии» → «+ Сценарий».

  

• Заполним поле «Наименование». Укажем например [Модульбанк] Создание ссылки

  

• В блоке «Какое событие запускает сценарий?» необходимо указать с каким Объектом будет работать сценарий, например Заказ покупателя.
  
  Указываем Событие → Статус изменен. И теперь чтобы на каждом статусе не печатался чек, мы указываем статус на котором сработает Действие.
  
  Начальный статус может быть любым, а вот сработать при переходе в Следующий статус, например на статус В обработке.

  

• В блоке «Что нужно сделать?» нажимаем кнопку Добавить действие и выбираем вариант Добавить действие из решения.

  

• МойСклад добавит поле для выбора Действия. Укажите действие Создать ссылку на оплату и сохраните результат настройки.

  

• В разделе «Сценарии» теперь виден наш активный сценарий.

  

• В разделе История выполнения сценария будет отображать история срабатывания Сценария, в том числе при наличии ошибок, приложение будет возвращать результаты. Изучая историю, вы сможете самостоятельно исправить ошибку.