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

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

  

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

  

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

  

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

• Перед вами открывается раздел настроек «Альфа-Банк». Заполните его данными из письма отправленного банком (в некоторых случаях настройки необходимо запрашивать у личного менеджера банка). Вам потребуется идентификатор логина (с постфиксом -api) и пароль.
  Примечание: только логины с постфиксом -api работают с приложением. Логин с постфиксом -operator используется для входа в личный кабинет интернет-эквайринга и не предназначен для создания ссылок по API.
  

  

Подключение callback-уведомлений

• Вопрос: Для чего это необходимо?
  Ответ: Это необходимо для переключения статуса оплаты заказа. При оплате по СБП только после подключения callback-уведомлений, статус заказа изменится. Так же, если вы сделаете возврат в личном кабинете интернет-эквайринга, мы получим уведомление и сменим статус заказа на Возврат.
  Порядок подключения: Перейдите в личный кабинет интернет-эквайринга. Ссылка для входа в него отправляется банком вместе с логин и паролем. Для входа используйте логин с постфиксом operator.

  

• Далее, в соседней вкладке откройте настройки приложения Альфа-Банк и скопируйте значение из поля Ссылка для Callback уведомлений.

  

• Перейдите в кабинете оператора в раздел Настройки → Callback уведомления.
  

  Порядок настройки:

  1. Тип коллбэка - Динамический, если нет этого варианта для выбора, укажите Статический
  2. Ссылка - указываем ссылку из приложения
  3. Дополнительные параметры - mdOrder и orderNumber
  4. Операции - можно указать все. Минимум нужно к отслеживанию: Успешное списание и Возврат.
  5. Тип подписи - не используется
  6. Токен - не используется

  

• В случае, если у вас нет раздела для настройки callback-уведомлений перейдите на вкладку Поддержка и создайте новую заявку с темой Другое.

  

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

  

Управление способами оплаты

• Приложение поддерживает два способа оплаты. Вы можете указать способ оплаты с помощью которого, вы будете создавать ссылки на оплату.
  1. Все способы оплаты - оплата на банковской форме (возможные варианты: картами, сбп, подели и др.)
  2. СБП - прямой способ оплаты по куэр-коду от НСПК

  

  В приложении предусмотрен вариант при котором выбор способа оплаты доступен в виджете.

  

  После активации данной опции, в виджет добавится поле с выбором способа оплаты.

  

Ограничения на создание ссылки на оплату

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

  

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

  

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

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

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

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

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

  

Закрывающие чеки

• Закрывающий чек - это чек полной оплаты с зачетом предоплаты.
  Функционал доступен в виде дополнительной кнопки в виджете для формирования закрывающего чека.

  Правила работы:

  1. Функционал доступен пользователям после подключения онлайн-кассы со стороны Альфа-Банка.
  2. Функционал по умолчанию доступен только при выборе Признак способа расчёта: Предоплата, Предоплата 100% и Аванс.

  

Частичные оплаты

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

  Правила работы:

  • Функционал по умолчанию доступен только при выборе Признак способа расчёта: Предоплата и Аванс.
  • В виджет будет добавлено поле для ввода процента от суммы заказа. По умолчанию, ссылку можно создать на 100%.
  • Добавление новых позиций в заказ не разрешается, так как в этом случае калькуляция остаточной стоимости будет нарушена.
  • Возврат частичной оплаты пока недоступен, по причине того, что API МойСклад не умеет создавать полный пакет документов на частичный возврат. На данный момент используйте возврат через ЛК оператора.
  • При работе с частичными оплатами всегда должен быть закрывающий чек.

  В процессе работы, может образоваться погрешность в виде нескольких копеек. Мы реализовали 2 сценария нормализации последней оплаты с вычислением получившейся погрешности. В случае, если вы встретите аномалию, сообщите нам об этом по контактам указанным в пункте Техническая поддержка.

  

Агентские схемы

• Агентская схема подходит продавцам, кто работает с клиентами от имени других организаций.

  В схеме участвуют две стороны: агент и поставщики. Приложение поддерживает 3 типа поставщиков.

  1. Комиссионер
  2. Поверенный
  3. Агент

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

  

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

  

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

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

  Поддерживаемые типы документов:

  1. Входящий платеж
  2. Отгрузка
  3. Возврат покупателя
  4. Исходящий платеж
  
  Например: после оплаты приложение может добавлять Входящий платеж и Отгрузку, при возврате денежных средств создавать Возврат покупателя и Исходящий платеж. В приложение добавлено несколько разделов с настройками для каждого типа документов. Вы можете включить собственные правила создания этих документов.
  
  Важно: документ Отгрузки и некоторые другие виды, добавляются только в случае, если товар присутствует на складе.
  

  

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

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

  

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

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

  

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

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

  

Взаимодействие с виджетом

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

  

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

  

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

  

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

  

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

  

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

  

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

  

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

  

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

• Для проведения тестов в настройках приложения предусмотрен раздел тестирования. Для активации тестового режима поставьте галочку в специальное для этого поле.
  Внимание! Данная опция активна не у всех клиентов Альфа-Банк, встречаются ситуации при которых, после включения опции и переходу к тестированию по ссылке, вы можете увидеть ошибку: Код 5, доступ запрещен.
  Дело в том, что по умолчанию операции тестирования, отмены и подтверждения оплаты (двухстадийная оплата) доступна после согласования с личным менеджером банка. Для активации опции, обратитесь в техническую поддержку банка для получения разрешения на работу с данной операцией.
  

  

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

  

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

  

• Далее банк будет эмулировать отправку смс подтверждения оплаты. Для тестов нам нужно ввести числа 12345678. Далее нас банк переведет на страницу успешно оплаченного заказа.

  

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