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

Введение

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

Шаги по подключению

1. Пройти предварительные организационные шаги для подключения к платежному шлюзу (заключение договора с банком, подключение услуги интернет-эквайринга, регистрация в Системе быстрых платежей (СБП) и т.д.).
2. Получить тестовые доступы от банка для подключения к тестовой среде («Песочнице»).
   Состав данных предоставляемых со стороны банка:
   • Идентификатор клиента - Client Id
   • Секретный ключ клиента - Client Secret
   • Идентификатор ресурса - Merchant-Authorization
3. Установить приложение.
4. Установить приложение и внести в него тестовые доступы полученные от банка.
5. Включить в приложении опцию Режим тестирования.
6. Проверить интеграцию с Банком на примере создания тестового заказа.
7. После успешного выполнения тестовых кейсов (прием оплаты, отмена, возврат оплаты), необходимо предоставить ответственным лицам со стороны Банка, результаты выполнения тестирования.
8. Получить боевые доступы от сотрудников Банка для подключения к Production и началу продаж.
9. Заменить в настройках приложения тестовые доступы на боевые и отключить режим тестирования.

Установка приложения

• Для перехода к установке приложения нажмите кнопку Установить

  

• После установки приложения нажмите кнопку Перейти в приложение.

  

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

• После входа в приложение, вам откроется раздел настроек. Для активации необходимо заполнить раздел Подключение к API данными полученными от представителя Банка.
  
  Вам потребуется:
  • Идентификатор клиента - Client Id
  • Секретный ключ клиента - Client Secret
  • Идентификатор ресурса - Merchant-Authorization

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

  

Активация печати чеков

• Банк ВТБ позволяет подключать к себе онлайн-кассу для соблюдения 54-ФЗ «О применении ККТ». На текущий момент, вы можете подключить к сервису кассу Первый ОФД.

  Сам процесс состоит из двух основных пунктов:

  1. Подключить кассу к Банку ВТБ.
  2. Включить печать чеков в приложении.

  Основная настройка кассы производится в личном кабинете интернет-эквайринга в разделе «Настройка ресурсов» → «Настройка сервиса фискализации (54-ФЗ)».

  Со стороны приложения, в настройках вам необходимо активировать опцию Включение/выключение формирования чеков

  

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

  

Особенности работы с НДС

• Приложение поддерживает три способа работы с НДС.
  1. НДС по умолчанию
  2. НДС из товаров
  3. Расчетный НДС для предоплат

  
  Если у вас освобождение от НДС или ставка на все товары фиксированная, для вас НДС по умолчанию идеально подойдет.

  Для продавцов со смешанной ставкой, НДС из товаров позволит всегда точно передавать ставку для товаров.

  В случае, если вы работаете по предоплате, регламент работы с НДС требует передавать расчетный НДС. Схема работает по аналогии с НДС из товаров.

  

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

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

  

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

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

  

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

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

  

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

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

  

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

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

  

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

  

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

  

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

  

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

  

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

  

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

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

  

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

  

• Перед нами пример формы оплаты ВТБ. Для проведения успешного платежа воспользуемся тестовой картой.
  Вбиваем в поля формы:
  • Номер карты: 4111 1111 1111 1111
  • Месяц/Год: 12/24
  • CVV: 111

  

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

  

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