Инструкция по интеграции МойСклад и Точка банк (интернет-эквайринг)

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

  

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

  

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

  

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

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

  

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

• Рассмотрим вариант подключения с помощью JWT-ключа. Переходим в Точка →  Сервисы → Интеграции и API.

  

• Если до этого вы ни разу не делали интеграций, вы увидите приветственный экран. Нажмите кнопку Приступим.

  

• В верхней части раздела нажмите кнопку Подключить.

  

• Выбираем вариант Сгенерировать JWT-ключ.

  

• Указываем название ключа. Это будет полезно, если вам потребуется делать еще несколько интеграций и не путаться в них.

  

• Предоставляем доступы ключу. Нажимаем кнопку Сохранить.

  

• Ставим согласие с офертами и обработкой данных и нажимаем Создать ключ.

  

• Банк отправит вам смс код, для подтверждения действий.

  

• JWT-ключ выпущен, теперь можно скопировать значения и перенести их в приложение в МойСклад.

  

• После того, как соединение с банком установлено, нам необходимо указать из списка Способы оплаты подходящий нам вариант. На выбор доступно два варианта Оплата картами и СБП.
• Далее важное указать  Ответственного пользователя за оплаты. Список ответственных пользователей, мы извлекаем по API из банка. Не путайте их с сотрудниками из МойСклад, это разные списки людей. Нажимаем кнопку сохранить.

  

Настройка СБП оплаты

• Для активации работы с СБП, нам необходимо указать в поле Способы оплаты нужный вариант. Нам доступно два варианта Оплата картами и СБП.

• После выбора способа оплаты СБП, в приложении добавляются дополнительные поля формы.

  

• Нам необходимо указать реквизиты счета для зачесления денежных средств из выпадающего списка.

  

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

  

• Перейдите в личный кабинет Точка → Сервисы → QR-платежи.

  

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

  

• Банк откроет форму добавления точки. Вам необходимо будет заполнить краткую анкету о точке продаж.

  

• После создания точки продаж, в нижней части страницы, нажмите на кнопку Идентификаторы для интеграции.

  

• Скопируйте значения из этих полей и перенесите их в приложение в одноименные поля.

  

• Заполняем поля формы данными о торговой точке.

  

Автоматическая смена статусов заказа и счета

• После оплаты заказа или счета приложение может поменять статус согласно таблице сопоставления. Обратите внимание, можно явно отключить смену статуса, указав вариант Неактивный статус.

  

Автоматическое создание документов

• Для удобства вашей работы, в приложение добавлен функционал создания документов на разные ситуации. Например: после оплаты добавляется Входящий платеж и Отгрузка, при возврате создается Возврат покупателя и Исходящий платеж. В этом разделе, вы можете включить собственные правила создания этих документов.
  
  Важно: документ Отгрузки и некоторые другие виды, добавляются только в случае, если товар присутствует на складе.
  

  

Автоматическое создание задач для менеджера

• Для того, чтобы вы своевременно узнали об оплате вашего покупателя, в приложение добавлены блоки управления созданием задач для сотрудников. В приложении было выделено два основных вида событий: Оплата и Возврат. В данном разделе, вы можете указать собственный текст задачи. Указать ответственного за это событие и ответственного за исполнение задачи.

  

Настройка прав менеджеров при работе с виджетом

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

  

Завершение настройки приложения

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

  

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

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

  

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

  

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

  

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

  

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

  

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

  

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

  

Как работать с оплатами

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

  

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

  

• Заполним форму нашей картой. Нажмем на кнопку Оплатить картой.

  

• Далее нажимаем кнопку Вернуться в магазин.

  

• Результат успешной оплаты заказа в МойСклад.

  

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

  

• Дополнительно, приложение добавит Задачу менеджеру для проверки оплаты.