Инструкция по интеграции «Битрикс24» и «Долями» от Тинькофф Банк

• В маркеплейсе Битрикс24 необходимо перейти в раздел «Платежные системы» и найти в поиске приложение «Долями».

  

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

  

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

• Далее вам откроется доступ к настройкам терминала для приема платежей. Вам необходимо использовать логин и пароль, полученные от персонального менеджера. Также, вам потребуется использовать сертификат open-api-cert.pem и private.key, с помощью которого будут подписываться запросы. Файлы сертификата и приватного ключа откройте в любом текстовом редакторе, далее скопируйте содержимое в поля формы подключения и сохраните результат.  Если на данном этапе у вас нет данных настроек, далее мы опишем подробный процесс подключения к Долями.

  

Оформление заявки на подключение к Долями

• Для подключения к сервису Долями, перейдите в верхнее меню в личном кабинете Т-Бизнес → «Сервисы» → «Долями»

  

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

  

• На втором шаге, укажите данные вашей компании и реквизиты для расчетного счета

  

• Шаг третий, укажите данные руководителя организации.

  

• Шаг четвертый, укажите контактное лицо. Может быть руководитель указанный на прошлом этапе или другой сотрудник.

  

• Шаг пятый, оформление заявки. Скачайте заявку на присоединение. Распечатайте документ и подпишите его.

  

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

  

• Заявка переходит на рассмотрение. По результатам, вам придет смс-уведомление. А пока идет рассмотрение, приступим ко второй части настройки, выпуску сертификатов для интеграции.

  

Создание TLS-сертификатов

• Для создания TLS-сертификатов перейдите в верхнее меню в личном кабинете Т-Бизнес → «Сервисы» → «Интеграции»

  

• Перейдите на вкладку T-API и выберете пункт «Выпуск сертификата». После нажатия на кнопку будет запущен мастер пошаговой настройки.

  

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

  

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

  

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

  

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

  

• Спустя некоторое время, сертификат выпущен. Нажмите кнопку скачать.

  

Создание магазина для Долями

• После получения сообщения о подключении Долями. Переходим в верхнее меню личного кабинета Т-Бизнес → «Сервисы» → «Долями»→ «Магазины».

  

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

  

• Указываем данные магазина, название и включаем опцию Долями. Нажимаем кнопку Добавить магазин

  

• Процесс активации магазина запущен. Ждем проверку сотрудниками банка.

  

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

  

Добавление менеджера магазина

• Пока идет проверка магазина, перейдите на вкладку Менеджеры, в данном магазине. Нажмите кнопку Добавить менеджера

  

• Менеджер магазина добавлен. Теперь все этапы первичной настройки завершены.

  

Добавление TLS-сертификатов в приложение

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

  

Включение печати чеков со стороны Долями

• Примечание: подключать онлайн-кассу необходимо только в одном месте, либо со стороны Долями, либо со стороны Битрикс24. При одновременной активации, вы задублируете чеки.
  
  Сервис Долями позволяет подключать к себе онлайн-кассы для соблюдения 54-ФЗ «О применении ККТ». На текущий момент, вы можете подключить к сервису одну из перечисленных онлайн касс: CloudKassir, Атол, Бизнес.ру Онлайн-чеки, Комтет Касса, Aqsi.online, E-com Kassa, Ferma (ofd.ru), Orange Data.
  
  Сам процесс состоит из двух основных пунктов:
  1) Подключить кассу к Долями. Список требований сервиса смотрите по ссылке.
  2) Включить печать чеков в приложении.
  
  При выполнении только одного из пунктов, приложение будет выбивать ошибку и перестанет формировать чеки.
  Со стороны приложения в настройках необходимо активировать опцию Включение/выключение формирования чеков

  

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

  

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

  

Включение опции печати чеков со стороны Битрикс24

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

  

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

  

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

  

Тестирование оплаты в сделке

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

  

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

  

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

  

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

  

• Заполняем тестовыми данными покупателя.

  

• Сервис информирует нас о разделении оплаты на 4 части с указанием графика платежей и суммы. Нажимаем кнопку Оплатить.
  

  

• Наш заказ оплачен, можем вернуться на страницу нашего заказа. Для этого нажмем кнопку Вернуться в магазин.
  

  

• На странице оформления заказа видим статус Оплачено.

  

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

  

Тестирование оплаты в старых счетах

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

  

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

  

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

  

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

  

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

  

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

  

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

  

Тестирование оплаты в новых счетах

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

  

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

  

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

  

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

  

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

  

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

  

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

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

  

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

  

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