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

• В Битрикс24.Маркет необходимо перейти в раздел «Платежные системы» и найти в поиске приложение Точка банк (интернет-эквайринг).

  

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

  

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

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

  

Подключение с помощью OAuth 2.0

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

  

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

  

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

  

• Финальный шаг, предоставление доступов. Нажмите кнопку Предоставить доступ.

  

• Доступ успешно предоставлен. Нажмите кнопку Готово для завершения операции и возврата в приложение.

  

Подключение с помощью JWT-ключа

• Теперь рассмотрим вариант подключения с помощью JWT-ключа.

  

• Далее переходим в Точка → Сервисы → Интеграции и API.

  

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

  

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

  

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

  

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

  

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

  

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

  

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

  

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

  

Настройка интернет-эквайринга

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

  

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

  

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

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

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

  

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

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

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

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

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

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

  

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

  

Включение печати чеков

• В случае, если вы уже подключили внешнюю онлайн-кассу для печати чеков к Битрикс24, то вам необходимо сделать дополнительную настройку. Для этого переходим в раздел Сайты и Магазины → Платежи и доставка →  Платежные системы.
  Если касса еще не подключена, то в нижней части страницы добавлены товары к статье.
  Список состоит из онлайн-касс опубликованных нашей компанией. 
  

  

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

  

• Включаем опцию Разрешить печать чеков. Сохраняем наши настройки.
  

  

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

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

  

• В таймлайн сделки Битрикс24 добавляет ссылку на оплату. Откроем данную ссылку в новой вкладке.

  

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

  

• Банковский сервис предлагает нам два варианта Оплатить картой или Оплатить QR-коду. Нажмем на кнопку Оплатить картой.

  

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

  

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

  

• В сделке так же отображается успешная оплата.

  

Как работать с оплатами в старых счетах

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

  

• Переходим в раздел Прочие настройки.

  

• В нижней части настроек находится блок Настройка счетов. Поставьте флаг в опции Включить раздел старых счетов.
  

  

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

  

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

  

• Копируем ссылку на счет и открываем в новой вкладке.

  

• Выбираем платежную систему Точка банк в правой части счета и переходим к оплате. Последующий порядок тестирования аналогичен тому, что мы уже описали в пункте Как работать с оплатами в сделке.

  

Как работать с оплатами в новых счетах

• Для создания счета нового типа необходимо в сделке перейти на вкладку Счета. Нажмите кпопку +Счет.

  

• После создания откроется вкладка редактирования счета. Теперь нажмите кнопку Принять оплату.

  

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

  

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

  

• При открытии ссылки на оплату данная страница отличается присутствием счета для оплаты юридическим лицом. Ниже располагаются платежные системы и оплата ничем не отличается от процесса описанного выше в пункте Как работать с оплатами в сделке.

  

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

  

Ограничение работы платежной системы по источнику заказа

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

  

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

  

• Сохраняем наши настройки. Теперь при работе со счетами, у нас будет отображать эта платежная система. А в других местах она будет недоступна. Таким образом, мы простыми настройками разделили способы оплаты.

  

Виджет управления списком транзакций

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

  

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

  

• Например: если вам требуется совершить возврат, то вы сможете его сделать не выходя из Битрикс24.