Инструкция по интеграции «Битрикс24» и «Сбербанк»

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

  

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

  

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

• После установки приложения открывается раздел настроек «Сбербанк». Заполните его данными из письма отправленного банком. Вам потребуется идентификатор логин c постфиксом -api и пароль.

  

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

  

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

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

  

• Перейдите на вкладку Поддержка для создания нового обращения.

  

• Далее, в соседней вкладке откройте откройте настройки приложения. Зайдите в приложение Сбербанк и скопируйте URL-адреса сервера уведомлений. Далее возвращаемся в личный кабинет интернет-эквайринга для составления текста обращения.

  

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

  

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

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

  

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

  

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

  

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

  

• Далее проведем тестирование ссылки на оплату. При открытии ссылки на оплату в тестовом режиме, нам доступна оплата картой.
  

  

• Для проведения успешного платежа воспользуемся тестовой картой. Вбиваем в поля формы Номер карты 4111 1111 1111 1111, Месяц/Год 12/24, CVC 123 нажимаем Оплатить.

  

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

  

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

  

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

  

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

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

  

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

  

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

  

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

  

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

  

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

  

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

  

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

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

  

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

  

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

  

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

  

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

  

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

  

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

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

  

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

  

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

  

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

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

  

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

  

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

  

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

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

  

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